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PREFACE 



The software described in this manual is 
furnished to purchaser under a license for 
use on a single computer system, and can be 
copied (with inclusion of DEC's copyright 
notice) only for use in such system, except 
as may otherwise be provided in writing by 
DEC. 



This manual provides information needed to install and manage 
a BATCH-11 or DOS-11 system. It is organized as follows: 

Chapter Purpose 

1 Describe the contents of each distribution 
kit; define terminology. 

2 Define procedures for installing the Monitor 
and system programs; describe backup and 
recovery procedures. 

3 Define procedures for tailoring the Monitor; 
describe the configuration module. 

4 Describe standard system modules (device 
drivers and EMT's, and how to add, delete 
or replace them with user-written, non- 
standard modules. 



NOTE 



Chapters 3 and 4 are intended for sophi- 
sticated users. Procedures defined are 
not recommended for inexperienced users, 



Infojnnation pertinent to managing a BATCH-11 
installation - default UIC, standard job 
termination procedure files. 

PIP facilities of interest to system manager: 
file management, control of system usage, etc, 



Appendices A through H contain information of general interest. 
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GUIDE TO THE MANUAL 

This section will aid in gaining quick access to specific 
information. 



If You Need to Know About 

1. Loading a Monitor from Paper Tape. 

2. Loading a Monitor from DECtape. 

3. Loading a Monitor from Magnetic Tape. 

4. Loading a Monitor from system disk, 
when SYSLOD is core resident. 

5. Rebooting a Monitor. 

6. Loading System Programs with the BATCH-11 
Monitor. 

7. Loading System Programs with the IX)S-11 
Monitor. 

8. Putting Version Vj2f8 of the Monitor on 
an old disk. 

9. Modifying the following configuration 
module elements: 

Default UIC 

Clock Routine 

Devices Available 

EMT's 

Non-standard devices 

10. Modifying the Configuration Module 

11. Making Monitor modules resident 

12. Adding, deleting or replacing device driver 

13. Adding EMT's 

14. Modifying Batch Procedure Files 

15. Modifying Batch Job Termination Files 

16 UIC Management 
Listing 
Entering 
Withdrawing 



See 
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If You Need to Know About See Section 

17 File Management 6.3 

Listing Directories 6,3.1 

Deleting Files 6.3.2 

Transferring Files 6,3,3 



NOTATION CONVENTIONS 

All command strings shown in this manual must be tejnninated by 
typing the RETURN key, unless otherwise indicated. Although the 
RETURN key is typed to enter a line to the system, it does not echo 
on the teirminal paper except to perform a carriage return/line feed 
operations. 

Characters printed by the system are underlined to differentiate 
them from characters typed by the user. 

Lower case letters appearing in a command string indicate notation 
variables whose values must be specified based on the installation con- 
figuration. For example, sysdev: indicates the system disk specifier 
and disdev: indicates the specifier for the distribution medium. The 
legal values for these notation variables are defined and explained 
when they are initially required in the system generation procedure. 
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SOFTWARE SUPPORT CATEGORIES 



Digital Equipment" Corporation (DEC) makes available four categories of software. These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 
The four categories are as follows: 



CATEGORY I 
Software Products Supported at no Charge 

This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category I to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party . 



CATEGORY II 
Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC , 



CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software p-oducts to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category III software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 



CATEGORY IV 
Non- Su ppor ted Software 

This category includes all programs for which no support is given 



VI 



CONTENTS 



PREFACE 
CHAPTER 



1 INTRODUCTION TO BATCH/DOS-11 SYSTEM 
DISTRIBUTION AND GENERATION 

1 . OVERVIEW 

1.1 DISTRIBUTION KITS 

1.1.1 Monitor Components 

1.1.2 System Programs 
1^1.3 FORTRAN ComDOnents 
1.1.4 Device Driver Sources 

1.2 TERMINOLOGY 

1.3 SYSTEM FACILITIES 

1.3.1 System Loader 

1.3.2 CILUS Program 



CHAPTER 2 GETTING ON THE AIR 

SYSTEM LOADER (SYSLOD) 



2.1 

2.1.2 DECtape Procedures 

2.1.3 Magtape Procedures 

2.1.4 Loading the Monitor 

2.1.5 Rebooting the Monitor 

2.2 GETTING SYSTEM PROGRAMS ON THE AIR 

2.2.1 BATCH-11 Procedure 

2.2.2 DOS-11 Monitor Procedures 

2.2.3 RCll Procedures 

2.2.3.1 BATCH Procedures 

2.2.3.2 DOS Procedures 

2.3 BACKUP PROCEDURES 

2.3.1 Use of ROLLIN 

2.3.2 Use of PIP 

2.3.3 Reloading the System Disk 

2.4 USING SYSLOD WITH AN EXISTING SYSTEM DISK 

2.5 ENTERING UIC'S 



Page 



1-1 
1-2 
1-2 
1-3 
1-4 
1-5 

1-5 

1-7 
1-7 
1-7 



2-1 
2-1 
2-3 
2-4 
2-5 
2-8 

2-9 

2-9 

2-11 

2-16 

2-16 

2-17 

2-18 
2-18 
2-19 
2-20 

2-20 

2-20 



CHAPTER 3 MONITOR MODIFICATIONS 

3.1 INTRODUCTION 3-1 

3.2 BUILDING THE CONFIGURATION MODULE 3-1 

3.3 EDITING SYSTEM. MAC 3-2 

3.3.1 Default UIC Value 3-2 

3.3.2 Clock Routine Definition 3-3 

3.3.3 Standard Devices 3-3 

3.3.4 User-Written EMT's 3-4 

3.3.5 Non-standard Devices 3-5 

3.3.6 Configuration Title 3-5 

3.3.7 Steps in Modifying the Configuration Module 3-6 

3.3.8 Monitor Initialization Command Strings 3-8 

3.4 CAUTIONS 3-9 

3.5 MONITOR MODULE RESIDENCY NOTES 3-11 



CHAPTER 4 



SYSTEM FACILITIES 



4.1 DEVICE DRIVERS 

4.1.1 Naming Convention for Device Drivers 

4.1.2 Assembling Device Drivers 



4-1 
4-1 
4-2 



Vll 



4.1.3 Adding Device Drivers 

4.1.4 Deleting Drivers 

4.1.5 Replacing Drivers 

4.2 EMT MODULES 

4.2.1 Adding EMT's 

4.2.2 Deleting EMT's 

4.2.3 Replacing EMT's 

CHAPTER 5 BATCH-11 CONSIDERATIONS 

5.1 INTRODUCTION 

5.2 CONCISE COMMAND PROCEDURE FILES 

5.2.1 Assembling and Linking Edited Procedure 
Files 

5.3 JOB TERMINATION PROCESSING 

5.3.1 CLl.SYS 

5.3.2 CL2.SYS 

5.3.3 CL3.SYS 

5.3.4 CL4.SYS 

5.3.5 CL5.SYS 

5.3.6 CL6.SYS 

5.3.7 CL7.SYS 

5.3.8 Default File (CL0.SYS) 

5.3.9 Editing Job Termination Files 

5.4 MODIFYING THE DEFAULT UIC 

CHAPTER 6 PIP SYSTEM MANAGEMENT FACILITIES 

6.1 PIP FUNCTIONS 

6.2 MANAGING UIC'S 

6.2.1 Listing UIC's (/UIC) 

6.2.2 Entering UIC's (/EN) 

6.2.3 Withdrawing UIC's (/WD) 

6.3 FILE MANAGEMENT 

6.3.1 Listing File Directories. (/DI) 

6.3.2 Deleting the Files (/DE) 

6.3.3 Transferring Files 

6.3.4 Superseding Files 

6.4 DEVICE INITIALIZATION 



Page 

4-4 
4-5 
4-5 

4-6 
4-6 
4-6 
4-6 



5-1 
5-1 

5-3 

5-4 
5-5 
5-5 
5-5 
5-5 
5-5 
5-6 
5-6 
5-6 
5-7 

5-7 



6-1 

6-1 
6-2 
6-3 
6-3 

6-4 
6-4 
6-5 
6-5 
6-6 

6-6 



APPENDIX A SYSTEM GENERATION BATCH STREAMS 

APPENDIX B SYSTEM CORE REQUIREMENTS 

APPENDIX C MONITOR EMT MODULES 

APPENDIX D SYSTEM DISTRIBUTION KITS 

APPENDIX E STANDARD CONFIGURATION MODULE 

APPENDIX F SYSLOD NOTES 

APPENDIX G CILUS NOTES 

APPENDIX H RESERVED FILENAME EXTENSIONS 



A-1 
B-1 
C-1 
D-1 
E-1 
F-1 
G-1 
H-1 



Vlll 



CHAPTER 1 



INTRODUCTION TO BATCH/DOS- 11 SYSTEM 
DISTRIBUTION AND GENERATION 



1,0 OVERVIEW 

The current distribution of the BATCH-11 and DOS-11 systems repre- 
sents a significant departure from past DOS-11 distributions. In the 
past, the practice has been to tailor a system to the particular disk 
used as the system device (RCll, RFll, or RKll) . This had the follow- 
ing effects: 

1- Three different versions of the system had to be kept 
up-to-date; 

2. Different system generation procedures had to be used 
for different disks. 

Under the current scheme, one DOS-11 system, or one BATCH-11 
system, is distributed, depending on which system the user has speci- 
fied. System generation varies only slightly because of the disk 
used as the system device. Also, updates to a system are sent to 
all users, in a timely fashion, since only one version of DOS-11 
or BATCH-11 has been distributed. 

The contents of each distribution kit are: 

1. A DOS-11 or BATCH-11 Monitor with Getting on the 
Air (GOA) batchstreams (note that BATCH-11 in- 
cludes all DOS-11 facilities) ; 

2. A System Loader program (SYSLOD) ; 

3. System programs (MACRO-11 assembler, linker, editor, 
etc. ) ; and, 

4. A FORTRAN Compiler and Object Time System components 

(supported only on configurations of 12K or more core 
sizes). Pertinent information is contained in Getting 
FORTRAN On the Air, DEC-11-LFOAA-B-D. 

Though each BATCH-11 or DOS-11 distribution kit contains the 
same components as every other BATCH-11 or DOS-11 kit, certain dif- 
ferences exist in the usability of these components. These differ- 
ences are based on the memory size of the configuration. For instance, 
FORTRAN is not supported in less than 12K; 8K and 12K configurations 
must use somewhat limited versions of the MACRO-11 Assembler. In the 
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case of the 8K user, a subset of the full Permanent Symbol Table 
and a PAL-llR subset of MACRO-11 (in overlaid form) must be used. The 
12K user can use the full MACRO-11, but must use it in overlaid 
form. 

The media used to distribute the BATCH-11 or DOS-11 system are 
described below. 

1.1 DISTRIBUTION KITS 

The BATCH/DOS-11 system is distributed as one of four kits, 
designed for the following media: 

1. High-speed paper tape; 

2. DECtape; 

3. 7- track magnetic tape; and, 

4. 9-track magnetic tape. 

Each package supports the following disks as the system device: 
RCll, RFll, and RKll (high density). 

The system as distributed consists of one of the following kits: 

1. DOS-11 Monitor, including system programs, and 
FORTRAN; or, 

2. BATCH-11 Monitor, including system programs, and 
FORTRAN. Also included are the Getting on the 
Air (GOA) batch streams, which are listed in 
Appendix A of this manual. 



1.1.1 Monitor Components 

The Monitor components common to both kits are: 

MODULE 
NAME FUNCTION FORMAT 

SYSLOD.CIL System Loader. Transfers CIL (1.2)^ 

MONLIB.LCL to disk 

MONLIB.LCL Monitor Library. LICIL (1,2)^ 

RMON.LDA Needed for Configuration Module Load 
modification. (Ch. 3) ^ 



^ Refer to section or Chapter indicated, for details. 
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NAME 
RMON . STB 

TAIL.LDA 

SYSTEM. MAC 

CONFIG. MAC 
CFMAC . MAC 



FUNCTION 



MODULE 
FORMAT 



Input file for linking Configuration Symbol Table 
Module (3.3.8). 

Concatenated load modules used to build Load 
Monitor. (Includes TMON) . 



Input for assembly of 
Configuration Module . 

Configuration Module. 

Configuration Module macros. 



Source 

Source 
Source 



The BATCH-11 Monitor includes (in addition to the above) : 



NAME 



FUNCTION 



MODULE 
FORMAT 



CLj2f.SYS 

to 
CL7.SYS 

LDUMP . LDA 

CMOS . MAC 

TMON . OBJ ' 

CCL.OBJ 

BATMAN . OBJ 

LKP.OBJ 



BATCH job termination processing 
modules - delete scratch files, 
output log, dump-on-error. (Ch. 5) . 

Formatting program for error diamps . 

BATCH command file. 



Required for linking if CMOS file 
is modified by the installation. 



Source 

Load 

Source 

Object 

Object 

Object 

Object 



1.1.2 System Programs 

The system programs included in both distribution kits are: 



NAME 
MACRO . OBJ 

MACROP.OBJ 

MACOVR.OBJ 

PST.OBJ 
PSTP.OBJ 
PST.MAC 
SYSMAC . SML 



FUNCTION 



MODULE 

FORMAT 

Object 



The MACRO-11 Assembler object module. 
Usable in configurations of any size 
greater than 12K. Usable in 12K if linked 
with MACOVR.OBJ. 

PAL-llR subset of MACRO Assembler; Object 
for 8K systems. 

Linked with MACRO. OBJ to produce over- Object 
lay version for a 12K system. 

Full MACRO-11 symbol table. Object 

PAL-llR subset symbol table. Object 

Source of MACRO-11 symbol table. Source 

System Macro library. Source 
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NAME 



FUNCTION 



MODULE 
FORMAT 



MACROS. LDA 

EDIT. OBJ 

ODTllR.OBJ 

LIBR.OBJ 

FILDMP.OBJ 

CREF.OBJ 



SPIP.8K 
PIP.12K 
PIP.16K 

PIP. OBJ 

PIPOVjaf.OBJ 
PIPOVl.OBJ 
PIP0V2.0BJ 
PIP0V3.0BJ 

LINK.8K 
LINK0B.8K 



LINK.12K 
LINK0B.12K 

LINK. OBJ 
LINKOB.OBJ 

CILUS.OBJ 

CILUS0.OBJ 

CILUSl.OBJ 

CILUS2.0BJ 

CILUS3.0BJ 



Used only on 8K systems to assemble 
certain system modules, i.e., PST.MAC, 
CONFIG. MAC. 

Editor program 

On-line Debugging program 

Librarian. 

File Dump program. 

Assembler Cross-Reference program. 
(Not available for 8K systems.) 

Special versions of PIP, used to 
transfer system programs to the 
system device. SPIP.8K transfers 
system programs on 8K configurations. 



PIP File Utility program modules. 
Each module represents an overlay 
or resident file. 

Linker program, and Linker Overlay 
Builder, in 8K load module form 
(used to link system programs) . 

Linker program, and Linker Overlay 
Builder, in 12K load module form. 



Load 

Object 
Object 
Object 
Object 
Object 



Load 
Load 
Load 

Object 

Object 
Object 
Object 
Object 

Load 
Load 



Load 
Load 



Object module of the Linker. Object 

Object module of Linker Overlay Builder Object 



Core Image Library Update and Save Object 
program. 



1.1.3 FORTRAN Components 

The FORTRAN components distributed consist of the compiler and 
its associated files, and the Object Time System (OTS) and its related 
modules. Refer to the manual, Getting FORTRAN on the Air , DEC-11- 
LFOAA-B-D. 

NOTE 

Though FORTRAN is distributed with all DOS- 11 and 
BATCH-11 kits (including 8K configuration kits) , 
it is supported only for 12K configurations and 
above . 
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1.1.4 Device Driver Sources 

The following device driver source modules are included in each 
DOS-11 and BATCH-11 kit: 



MODULE 

DF.MAC 
DK.MAC 
CR.MAC 
MT.MAC 
DT.MAC 
KB. MAC 
PR. MAC 
PP. MAC 
LP. MAC 



FUNCTION 
KvJii cLnver , 
RFll driver. 
RKll driver. 
Card reader driver. 
Magnetic tape driver. 
DECtape driver. 
Console keyboard driver, 
Papertape reader driver, 
Papertape punch driver. 
Line printer driver. 



1.2 TERMINOLOGY 

The brief glossary that comprises this section defines the 
meanings of several terms used in subsequent sections of this 
manual. 



blocks logical 

A unit of disk space, consisting of a number of contiguous 
physical blocks. Logical block size is a multiple of the 
physical block size, where the multiplier is a power of 
two. For example, the logical block size of a file on an 
RCll disk might be 64, 128, 256, etc. 

block, physical 

The smallest addressable unit of disk storage, expressed as 
a decimal number of words. This varies according to the 
disk type, as: 

RFll, RCll - 64 words 
RKll - 256 words 



boot 

To load a program or Monitor into core, and begin its execution, 
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bootstrap 

A section of code which reads and passes control to another body 
of code. Typically, a short bootstrap (called the ROM boot), 
which is wired into the processor, is started by toggling the con- 
trol panel keys. The ROM boot reads one block (usually block 0) 
from a specified device into location J?, and gives it control at 
word J?. This block of code, also a bootstrap, then loads the 
Monitor . 

CIL 

Core Image Library (acronym) . A CIL consists of one or more 
Tmages, and an Index which contains a communications di- 
rectory (COMD) for each core image in the CIL, and a list 
of information describing the CIL itself (the CIL Line) . 

CIL Line 

The formatted binary line that contains information describ- 
ing the CIL to which it belongs. 



COMD 

COMm unications Directory (acronym) . The entry in the CIL Index 
that describes the core image, so that the core image can be 
loaded by the DOS Monitor. 

Core image 

The representation of a program as it appears when loaded in core, 
ready to execute. Conceptually, the result of simply writing an 
area of core to a device with no special formatting. 

Hook 

To enter key information about a CIL into the bootstrap 
(starting block, size, etc.). There may be many CIL's 
resident on a disk or DECtape , but only one may be "hooked" 
to the bootstrap. The hooked CIL (usually a Monitor) is 
the one that is loaded and executed when the bootstrap is 
run. 

LICIL 

Linked Core Image Library. A backup version of a CIL, in 
linked, rather than contiguous, format. LICIL's can be 
stored on disk, DECtape, paper tape, or magnetic tape. 
They are stored as linked files, because DOS-11 does not 
support contiguous files on all media, and because some informa- 
tion in the CIL depends on the block size of the device. 
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±. 3 SYSTEM FACILITIES 

One of the principal goals of the BATCH/DOS-11 system is to 
provide the user with capabilities to build, update, and maintain 
his system more easily than in the past. An enhanced System Loader 
(SYSLOD) greatly simplifies the task of loading the Monitor. The 
CILUS Drocrram allows the user to create and m.odifv the Monitor and 
other programs that are stored in the form of CIL's (core image 
libraries; refer to section 1.2 for a definition of CIL's). 



1.3.1 System Loader 

The System Loader (SYSLOD) loads the BATCH or DOS (or other) 
Monitor onto the system disk, boots it into core, and executes 
it. SYSLOD is a stand-alone program, in that it does not 
require DOS-11 or the DOS file structure on a disk. The func- 
tions of SYSLOD are described in Chapter 2 ("Getting On the 

^ir ; . 



1.3.2 CILUS Program 

CILUS is an acronym derived from Core I^mage Library Update and 
S_ave. It is a program that allows the user to build and maintain 
programs in the form of core image libraries (both contiguous and 
linked) . Its applicability to BATCH or DOS system generation de- 
rives from the fact that the BATCH or DOS Monitor is built and dis- 
tributed in the form of a LICIL (linked core image library) . CILUS 
is used when the user wishes to modify, test, or store a version of 
the Monitor. Appropriate information needed to use CILUS for these 
functions is provided in Appendix G. 
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CHAPTER 2 
GETTING ON THE AIR 

2.0 OVERVIEW OF INST ALLATION PROCEDURES 

This Chapter describes the process by which a user takes a 
distribution kit. and builds a runnina BATCH— 11 ox DOS— 11 svstern- 
The exact details of how this is done depend on the distribution 
medium, and the memory size of the configuration, but in general 
it involves: 

1. Loading and executing the Monitor, via SYSLOD; 

3. Loading FORTRAN components (see Getting FORTRAN on the Air , 
DEC-11-LFOAA-B-D) ; and, 

4. Creating a backup copy of the system. 

2.1 SYSTEM LOADER (SYSLOD ) 

The System Loader program (SYSLOD) loads a Monitor core image 
library (CIL) onto the system disk from the backup medium. Sec- 
tions 2.1.1 through 2.1.4, below, consist of the procedures nec- 
essary to get the BATCH/DOS-11 system on the air. 

2.1.1 Paper Tape Procedures 

A. No BM79 2-YA ROM 

When the BM792-YA ROM option is not available, use the following 
procedure: 

1. Toggle the Bootstrap Loader into core via the Console, 

loading the sequence of instructions shown below into the 
locations specified (i.e., nn7744 to nn7776, where nn is 
determined by available core; refer to Table 2-1). 
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The actual procedure is to set the Console Switch Register to 
the address nn7744, and depress LOAD ADDR. This puts nn77 44 into 
the Address Register. Now set the Console Switch Register to 16 7j2(l, 
and Raise the DEP button. The value 167j2fl is deposited into address 
nn7744, and the Address Register is automatically incremented by 2, 
as it is each time DEP is toggled. Continue by specifying the 
values shown in CONT below,, toggling DEP after each value is set in 
the Console Switch Register. 

LOC CONT 



nn7744 


16701 


nn7746 


26 


nn7750 


12702 


nn7752 


352 


nn7754 


5211 


nn7756 


105711 


nn7660 


100376 


nn7762 


116162 


nn7764 


2 


nn7766 


nn7400 


nn7770 


5267 


nn7772 


177756 


nn7774 


765 


nn7776 


177550 



2. Set Console ENABLE/HALT to HALT. 

3. Place the Absolute Loader paper tape into 
the high-speed paper tape reader. The 
special leader code (351) must be positioned 
over the read sensors. 

4. Set the Switch Register to nn7744, where nn is 
as specified in Step 1. 

5. Depress LOAD ADDR. 

6. Set ENABLE/HALT to ENABLE. 

7. Depress START. (The Absolute Loader is read 
into core, and the machine halts.) 

8. Place the SYSLOD tape, labelled DEC-11-OSLDA-A-PL, in 
the high-speed paper tape reader with blank 

leader tape over the read sensors. 

9. Set ENABLE/HALT to HALT. 

10. Set the Switch Register to nn7500, where nn is 
as specified in Step 1. 

11. Depress LOAD ADDR. 

12. Set ENABLE/HALT to ENABLE. 

13. Depress START. 
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SYSLOD is read into core. Skip to Section 2.1.4. 



Table 2-1 
VALUES SPECIFIED FOR NN 



MEMORY SIZE 


VALUE OF nn 


8K 


n 


12K 


05 


16K 


J07 


20K 


11 


24K 


13 


28K 


15 



B. BM792-YA ROM Available 

When the BM792-YA ROM option is available, use the following 
procedure: 

1. Set Console ENABLE/HALT to HALT. 

2. Set the Switch Register to 113jSjSyl , 

3. Replace the Absolute Loader paper into the high- 
speed paper tape reader, with the special leader code 
(351) over the read sensors. 

4. Depress LOAD ADDR. 

5. Depress START. (The Absolute Loader is read into core.) 

6. Place the SYSLOD tape, labelled DEC-11-OSLDA-A-PL, in 
the high-speed paper tape with blank leader tape over 
the read sensors. 

7. Set ENABLE/HALT to HALT. 

8. Set the Switch Register to nn75j2fj?, where nn is determined 
according to memory size (see Table 2-1) . 

9. Depress LOAD ADDR. 

10. Set ENABLE/HALT to ENABLE. 

11. Depress START. Skip to Section 2.1.4. 

2.1.2 DECtape Procedures 

The SYSLOD program is automatically loaded from DECtape using 
either the BM792-YB Bootstrap Loader, or the MRll-DB Bulk Storage 
Bootstrap Loader, depending on which is included in the hardware 
configuration . 



2-3 



/ BM792-YB ROM Procedure /•' 

/ 

1. Mount DECtape containing SYSLOD,^/ labelled 
S?€' S ^ DEC-11-ODMOA-A-UC, or DEC-11-OBMOA-A-UC, on 

DECtape unit j2(. (ODMOA is the DOS-11 version; 
OBMOA is the BATCH-11 version.) 

2. Set the REMOTE and WRITE LOCK switches on unit j2f. 

3. Set the Console ENABLE/HALT switch to HALT. 

4. Set the Console Register to 1731j2fJ?. 

5. Depress LOAD ADDR. 

6. Set ENABLE/HALT to ENABLE. 

7. Set the Switch Register to 177344. 

8. Depress START. 

SYSLOD is read into core. Skip to Section 2*1,4. 

MRll-DB Procedure 

1. Mount DECtape DEC-11-ODMOA-A-UC or 
DEC-11-OBMOA-A-UC on unit j2f. 

2. Set the REMOTE and WRITE LOCK switches on unit )2f. 

3. Set the Console ENABLE/HALT switch to HALT, then 
to ENABLE. 

4. Set the Console Switch Register to 17312j2f. 

5. Press LOAD ADDR. 

6. Press START. 

SYSLOD is loaded into core. Skip to Section 2.1.4. 

2.1.3 Ma gtape Procedures 

Two procedures may be used to load SYSLOD from magnetic tape 
(either 7- or 9-channel tape) . The first is to use the MRll-DB 
Bootstrap Loader as follows: 

1. Mount magnetic tape DEC-11-ODFSA-A-MC, or 
DEC-11-OBFSA-A-MC on unit jZf. The tape must 
be at the load point. Turn the unit ON LINE. 

(ODFSA is DOS-11; OBFSA is BATCH-11.) 

2. Set Console ENABLE/HALT to HALT, then to ENABLE, 

3. Set the Console Switch Register to 173136. 

4. Depress LOAD ADDR. 

5. Depress START. 

SYSLOD is loaded into core. Skip Section 2.1.4. 
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NOTE 

If SYSLOD does not type out its identification 
and the processor halts, it indicates that a 
parity error was detected in reading the tape. 
Retry the procedure. If the error persists, 
it will be necessary to obtain a replacement tape. 

When the MRll-DB Bootstrap Loader is not available, use the 
following procedure: 

1. Mount magnetic tape on unit jS , as above. 

2. Deposit the following routine into core 
via the Console Switch Register and the 
DEP switch. 



NOTE 

When an earlier 
version of DOS is 
available, the 
MODIFY command can 
be used to generate 
this routine. 



Address 


Contents 


Symbolic 


10000 


12700 


MOV #172524, R0 


10002 


172524 




10004 


5310 


DEC (R0) 


10006 


12740 


MOV #60011,- (R0) 


10010 


60011 




10012 


105710 


TSTB (R0) 


10014 


100376 


BPL .-2 


10016 


5710 


TST (R0) 


10020 


100767 


BMI ,-20 


10022 


12710 


MOV #60003, (R0) 


10024 


60003 




10026 


105710 


TSTB (R0) 


10030 


100376 


BPL .-2 


10032 


5710 


TST (R0) 


10034 


100777 


BMI . 


10036 


5007 


CLR PC 



3. Put 10000 in the Switch Register. 

4. Depress LOAD ADDR. 

5. Put ENABLE/HALT to ENABLE. 

6. Depress START. 

SYSLOD is read into core. Skip to Section 2 , 1-. 4 . 

O 1 A T.oarl-inrr t-'ho Mrcni-l-rcr 



When SYSLOD is in core, it identifies itself by printing the 
following message at the keyboard: 



SYSLOD Vxx 



(Note: XX is replaced by the SYSLOD 
version number.) 
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The Monitor is loaded by typing in the following conmand string: 

£sysdev:MONLIB.CIL/ZERO/HOOK/BOOT<disdev:MONLIB.LCL 

CAUTION 

The above command zeros the disk specified as 
"sysdev." Be sure to read section 2.4 before 
loading a V08 Monitor onto a current system disk, 

where: 

sysdev: is the system disk specifier, i.e., 

DC: = RCll 
DF; = RFll 
DKjaf:= RKll disk unit j3f. 

disdev: is the specifier for the distribution medium, i.e., 

-* DTja(:= DECtape unit n; 

MTj2f:= Magtape unit n; and, 

PR: = Paper tape reader. Paper tapes contamxng 
MONLIB.LCL must be mounted and read in the 
order DEC-11-ODMLA (or OBMLA) -A-POl to -P05, 
sequentially. The first paper tape must be 
mounted before the command string is input. 
After each of the tapes POl to P04 is read, 
the message 

Aj2f;2r2 06 332jZf 

PLEASE PRESS CONTINUE WHEN READY 

is printed. After mounting the next tape, de- 
press the CONTINUE switch on the console panel 
to read in the next segment of MONLIB.LCL. After 
the last paper tape is read, the Monitor comes on 
the air as described below. 

Switches 



The switches that may be specified in the SYSLOD command string 
are /ZERO, /HOOK, and /BOOT. Note that in the example 
these switches are completely spelled out. SYSLOD recognizes only 
the first two letters of each switch, however, so they can be 
abbreviated to /ZE, /HO, /BO, and /FO, at the user's option. 

/ZERO is the switch used to initialize the disk to 
the BATCH/DOS-11 file structure. This switch 
also clears the disk. 



NOTE 

The /FORMAT switch may be specified 
when the output device is the RKll 
disk. This switch causes the disk to 
be formatted with hardware information 
(read marks, etc.). (See Appendix F.) 
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/HOOK is the switch that causes the Monitor to be hooked 
to the bootstrap that loads the system* 

/BOOT is the switch that causes the system to be bootstrapped, 

/HOOK and /BOOT are SYSLOD defaults, and are not re- 
quired in the command. Any error detected during SYSLOD 
operation is reported via a message at the keyboard. These 
messages are summarized in Appendix F. 

The first time the Monitor comes on the air, it prints the 
following message, related to line frequency preceding its iden- 
tification; 

SYSLD COMPLETE! 

ANSWER WITH GARRET OR 'Y' GARRET ., g ^ ^ ^ 

IS YOUR LINE FREQUENGY 50 HERTZ? ki^^r. *t, v v5 u --^ 

The Monitor waits for either a carriage return, or a Y fol- 
lowed by a carriage return. Y^ indicates that the system is 
using a line frequency of 5)2 Hertz. If the response is simply ^, 
60 Hertz is assujned. ( _^ indic^utSB-ar QjLKXi,§,<^e j;eturn - or CARPJET.) 



The Monitor identifies itself by printing: 



DOS Vxx B ATCH Vxx 

J ■ ' -. ■ ■ - ■ ■ ■ --- or T T " ■ ■ — — — 



Any error detected during the Monitor initialization procedures 
is reported via a brief message on the teleprinter. Refer to 
Table 3-1, Chapter 3. Should problems arise at this point, con- 
tact a DEC Software Specialist. 

The Monitor can now be used to load and link system programs. 

Use the DATE and TIME commands to enter the correct date 
and time, and log-in, e.g.; 

£DATE 9 -OCT- 72 
$TIME ljaf:jaf5 
$L0 1,1 
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You are now ready to load and link system programs. Refer to 
Section 2.2. RCll systems users should refer specifically to 2.2.3 

2.1.5 Rebooting the Monitor 

Rebooting the Monitor is accomplished in one of two ways: 

A. BM792-YB Procedure 

1. If the system device is an RKll disk, turn WRITE ENABLE 
off. Otherwise go to Step 2. 

2. Depress HALT. 

3. Set the Switch Register to 1731j2fj2f. 

4. Depress LOAD ADDRESS. 

5. Set the Switch Register to one of the following values: 

177462 - RFll disk 
177406 - RKll disk 
177451? - RCll disk 

6. Turn HALT/ENABLE to ENABLE. 

7. Press START. 

B, MRll-DB Procedure 



1. Set the Console Switch Register to one of 
the following values according to which 
device is involved: 

RFll = 1731i2fjZ( 
RKll = 17311j2f 
RCll = 173220 



2. Depress HALT. 

3. Set Console HALT/ENABLE to ENABLE. 

4. Depress LOAD ADDR. 

5. Depress START. 

A successful Monitor reboot is indicated by a response of 
DOS Vxx or BATCH Vxx 
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at the keyboard. If this response is not forthcoming, retry the 
above procedure, making certain the correct Switch Register settings 
are used. Should a second attempt elicit no response, it is 
probable that the disk has been corrupted, and the Monitor is 
unusable. The cause of the problem should be determined, but the 
system disk will probably have to be reloaded. 

2 . 2 GETTING SYSTEM PROGRAMS ON THE AIR 

Once the Monitor is running, and the log-in procedure is com- 
pleted, it is necessary to load and link system programs. For 
BATCH-11 users, this is done by running a DEC-supplied batch stream, 
which resides on the distribution medium; refer to section 2.2.1. 

Users of the DOS-11 Monitor must follow the procedures described 
in section 2,2.2. RCll users should refer to section 2.2.3. 

2.2.1 BATCH-11 Procedure 

1. Run PIP, by typing in the following command; 

£RU dev:PIP.16K 

where "dev" is replaced by the mnemonic name of 
the distribution medium, viz.; 

PR: - Paper tape reader 

DT^: - DECtape unit j2f 

MTJ2f: - Magnetic tape unit j2f 



NOTE 1 

When the input medium is paper tape, it is not 
necessary to include a file name. The 
appropriate paper tape must be mounted in the 
reader prior to issuing the command, however. 
For DECtape and magnetic tape, the file name is 
obligatory. 

NOTE 2 



DECtape users, mount DECtapes as follows: 

Labe 1 Unit 

DEC-11-OCSPA-A-UCl jZf 

DEC-11-0CSPA-A-UC2 1 
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2. Type the following sequence of command strings to PIP 

Paper Tape 

£SY:G0AP16.D0S<PR:/FA/SU Mount G0AP16.D0S in reader 

#_SY:G0AP.16K<PR:/FA/SU Mount G0AP.16K in reader 

£SY:GOAP.ALL<PR:/FA/SU Mount GOAP.ALL in reader 

£SY:G0TA.16L<PR:/FA/SU Mount G0TA.16L in reader 

Go to step 3 . 

(Note: /FA indicates Formatted ASCII; /SU is the abbreviated form 
of /SUPERSEDE. See the PIP-11 Programmer's Manual for a discussion 
of PIP switches.) 

DECtape 

#SY : <DTl : G0TA16 . DOS/FA/SU 

£SY:<DT1:G0TA.16K/FA/SU 

£S Y : < DTI ; GOTA . ALL/FA/SU 

I^SY: <DT1:G0TA. 16L/FA/SU 

Go to step 3 . 

Magnetic Tape 
£SY : <MTj2f : G0AM16 . DOS/FA/SU 
£SY: <MTj2f : GOAM. 16K/FA/SU 
£SY : <MTj2f : GOAM . ALL/FA/SU 
#SY : <MTj2f : GOTA . 16L/FA/SU 



4. 



Kill PIP; 




#fc 




_^KI 




Invoke BATCH, specifying the appropr 


£BA G0AP16 .DOS 


(papertape) 


$BA G0TA16 .DOS 


(DECtape) 


$BA G0AM16 .DOS 


(Magnetic tape) 



At this point, the BATCH-11 Monitor begins reading a batch stream 
from the system device. Refer to Appendix A for a listing of the com- 
mand strings in the batch stream which load and link system programs. 
Messages are printed during the batch stream execution, indicating 
which tapes to mount. After mounting the indicated tape, type the CO 
command to continue. When loading and linking of system programs is 
completed, $FINISH and BATCH V xx messages are printed. At this point, 
refer to the FORTRAN Getting oh the Air document. If FORTRAN is not 
being installed, refer to section 2.3 for back-up procedures. 
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2.2.2 DOS-11 Monitor Procedures 

There is some variation in the procedures used for one distribu- 
tion medium or another, or for different system devices. RCll users 
should refer to section 2.2.3. RFll and RKll users proceed as follows 

1. Load the non-overlaid 12K version of PIP, using one of 
the followinq Monitor commands: 



i: TSTT'KT TTn 



£RUN DT0:PIP.12K 
$RUN MTi2f:PIP.12K 



DEC-11-UP12A-A-PL in the reader 
prior to issuing command. 

DECtape DEC-11-OCSPA-A-UCl 
should now be on DT0 

Magnetic tape distribution 
(7- or 9-track) 



Note that DECtape and magnetic tape users, with 8K 
configurations, must specify the special version of 
PIP in the above commands, as $RuN DT0;SPIP.8K or 
$RUN MT0:SPIP.8K respectively. 

PIP is loaded, and responds 

PIP Vxx 



2. Transfer the Linker load modules from the distribution 
medium to the disk, using PIP, The appropriate Linker 
load modules to transfer are determined by system core 
size, as shown in Table 2-2. 

TABLE 2-2 

CORE SIZE - LINKER RELATIONSHIP 



pairs; 



Core Size 


Modules to Transfer 


BK 


LINK.8K 
LINK0B.8K 


12K up 


LINK.12K 
LINK0B.12K 



The command strings specified must be one of the following 



For 8K 



#LINK.LDA<PR:/FB V 



Paper tape - tape DEC-11-UL8KA-A-PL1 
Tape DEC-11-UL8KA-A-PL2 



#LINKOB . LDA< PR : /FB 

#LINK.LDA<DT0:LINK 

fLINKOB . LDA< DT0 : LINKOB . 8K/FB 

#_LINK.LDA<MT0:LINK. 8K/FB 

#LINKOB. LDA<MT0: LINKOB. 8K/FBi or DEC-11-OBFSA-A-MC 



#LINK.LDA<DT0:LINK.8K/FB \ DECtape DEC-11-OCSPA-A-UCl on 

J unit 

iLINK.LDA<MT0:LINK.8K/FB \ Magnetic tape DEC-11-ODFSA-A-MC 
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For 12K or more : 

#LINK.LDA<PR:/FB 

#LINKOB . LDA<PR: /FB 



Place paper tape DEC-11-UL12A-A-PL1 
in reader. 

Place paper tape DEC-11-UL12A-A-PL2 
in reader. 



#LINK.LDA<DT0:LINK.12K/FB DECtape DEC-11-OCSPA-A-UCl on 

#LINK0B.LDA<E>Tj,:<:LINK0B.12K/FB unit 

#LINK.LDA<MT;j2f:LINK.12K/FB Magnetic tape DEC-11-ODFSA-A-MC 

#LINKOB.LDA<MTj2f:LINKOB.12K/FB or OBFSA-A-MC on unit 



3. Transfer the appropriate MACRO object modules - refer to 
Table 2-3. Note that 8K configurations use the PAL-11 
subset of MACRO (MACROP) , a smaller Permanent Symbol 
Table (PSTP) , and an Overlay version. The sole difference 
between 12K and over 12K MACRO is that 12K uses the over- 
lay version. 



TABLE 2-3 
CORE SIZE - MACRO RELATIONSHIP 



Core Size 


Module to Transfer 


8K 


MACROP . OBJ 
PSTP. OB J 
MACOVR.OBJ 


12K 


MACRO . OBJ 

MACOVR.OBJ 

PST.OBJ 


Over 12K 


MACRO . OBJ 
PST.OBJ 



The command strings are: 

8K Paper Tape 

#MACROP.OBJ<PR:/FB/SU 

£PSTP.OBJ<PR:/FB/SU 

#MACOVR.OBJ<PR:/FB/SU 



Tape to Mount (DEC-11-pref ix ) 



LMOPA-A-PR 
LMTPA-A-PR 
LMOVA-A-PR 



NOTE 

In the following examples, SY: is used 
when transferring files from DECtape 
or magnetic tape. SY: indicates the 
system device. Files are transferred 
to the system device, with the correct 
file name and extension. 
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8K DECtape 



T a pe to Mount (DEC-11-prefix) 



£SY : <DT0: MACROP . OBJ/F^/SU 
£SY:<DT^:PSTP.OBJ/Fe/SU 
#SY: <DTj3:MAC0VR.0BJ/FB/SU 

8K Magnetic Tape 

|_SY: <MTp:MACROP .OBJ/FB/SU 
£SY : <MT : PSTP . OBJ/FB/SU 
£SY: <MTi2f:MAC0VR. OBJ/FB/SU 

12K Paper Tape 

#MACRO . OBJ<PR: /FB/SU 
£PST . OBJ<PR: /FB/SU 
ijyiACOVR. OBJ<PR: /FB/SU 

12K DECtape 

#SY : <DT:jaf : MACRO . OBJ/FB/SU 
#_SY : <DT^ : PST. OBJ/FB/SU 
|_SY: <DT^:MAC0VR.0BJ/FB/SU 

12K Magnetic Tape 

£SY : <MTjaf : MACRO . OBJ/FQ/SU 
£SY : <MTi2f : PST . OBJ/FB/SU 
|_SY : <MT^ : MACOVR. OBJ/FB/SU 

Over 12K - Paper Tape 

£MACRO . OBJ<PR: /FB/SU 
#PST . OBJ<PR: /FB/SU 

Over 12K - DECtape 

£SY: <DT^: MACRO. OBJ/FB/SU 
# SY : <DT ja : PST . OBJ/FB/SU 

Over 12K - Magnetic Tape 

#SY: <MTJ2^: MACRO. OBJ/FB/SU 
#SY : <MT0. : PST . OBJ/FB/SU 



OCSPA-A-UCl 



ODFSA-A-MC 
OBFSA-A-MC! 



LMCOA-A-PR 
LMSTA-A-PR 
LMOVA-A-PR 



OCSPA-A-UCl 



(DOS— 11) 



ODFSA-A-MC or 
OBFSA-A-MC 



LMCOA-A-PR 
LMSTA-A-PR 



OCSPA-A-UCl 



ODFSA-A-MC or 

OEFSA-A-MC 



4. Continue using PIP until all system programs have been 

transferred. (Paper tape users will note that tapes are 
labelled as shown in Appendix D; tapes must be placed 
in the reader prior to issuing the command strings . ) 



Paper Tape Procedure 

The general form of the command used to transfer files from 
paper tape is: 

iprogname .ext<PR: /FB/SU 
where "progname .ext" is replaced by the program name and exten- 
sion of the file to be transferred. 
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Using this form, transfer the following programs: 
Program name & ext 

EDIT. OBJ 
LIBR.OBJ 
FILDMP.OBJ 
CREF.OBJ 
LINK. OBJ 
LINKOB . OBJ 
PIP. OBJ 
PIP0Vj2f.0BJ 
PIPOVl.OBJ 
PIP0V2.0BJ 
PIP0V3.0BJ 
CILUS.OBJ 
CILUSj2f.0BJ 
CILUSl.OBJ 
CILUS2.0BJ 
CILUS3.0BJ 
Specify also: 

£SYSMAC.SML<PR:/FA/SU 

DECtape Procedure 

Using PIP, specify the following commands: 

£SY:<DTj2(:*.0BJ/FB/SU Mount DEC-11-OCSPA-A-UCl 

^^ £Sy:<DTl: *.OBJ/FB/SU on DTj? 

#SY: <DT1:SYSMAG.SML/FA/SU Mount DEC-11-0CSPA-A-UC2 

on DTI 



Magnetic Tape Procedure 

£SY : <MT^ : * . OB J/FB/SU 

#SY : <MTj2f : SYSMAC . SML/FA/SU 



Link system programs as follows 

a. Kill PIP: 

fC 
_^KILL 

b. Run Link Overlay Builder 
$RUN LINKOB 

(no command string is used) 

c . Run Link : 
$_RUN LINK 
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Users with 16K or more of core memorY can now utilize the follow- 
ing command strings to link the maximum size version of the 
Linker: 

#LINK.LDA<LINK.OBJ/E 

£LINKOB , LDA<LINKOB . OB J/E 

fC 

^KI 

$_RUN LINKOB 

$RUN LINK 

d. Link correct version of MACRO by specifying one of the 
following command strings: 

£MACRO<MACROP . OBJ , MACOVR. OBJ , PSTP . OBJ/E ( 8K) 
|MACRO<MACRO.OBJ,MACOVR.OBJ,PST.OBJ/E (12 K) 

#MACRO<MACRO.OBJ,PST.OBJ/E Cover 12K) 

e. Link PIP to obtain the overlaid version, saving core: 

£PIP<PIP.0BJ/CC/0V:4/E 
#PIP0VJ3<PIP0VJ3 .OBJ/CC/E 
£PIP0V1<PIP0V1.0BJ/E 
#PIP0V2<PIP0V2 .OBJ/CC/E 
#P IP0V3 <P IP0V3 . OBJ/E 

f. Link remaining system programs: 



#EDIT<EDIT. OBJ/E 

£LIBR<LIBR.0BJ/E 

#FILDMP<FILDMP . OBJ/T : 37 46i2(/E 

£CREF<CREF. OBJ/E (omitted for 8K configurations) 

£CILUS<CILUS.0BJ/CC/0V:4/E 

£CILUSJ2I . 0VR<CILUSj2f . OB j/E 

£CILUS1 . 0VR<CILUS1 . OBJ/E 

£CILUS2 . 0VR<CILUS2 . OBJ/E 

iCILUS 3 .OVR<CILUS 3 .OBJ/CC/E 

6. Delete object modules from system disk: 

a. Kill the Linker: 
fC 

^KILL 

b. Run PIP: 

$RUN PIP 
PIPVxx 

£0DT/RE<0DT11R.0BJ 
£*. OBJ/DELETE 

C. £ODT.OBJ/RE<ODT 

vd. Install FORTRAN (12K or larger configurations only) 
See Getting FORTRAN on the Air , DEC-11-LFOAA-B-D. 



|lo.w''^ 
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2.2.3 RCll Procedures 

When the system disk is an RCll, the procedures described 
in 2.2.3.1 (BATCH) or 2.2.3.2 (DOS) must be used. 



u/ 2.2.3.1 BATCH Procedures 

1. Mount DEC-11-OCSPA-A-UCl on DT0; 
mount DEC-11-0CSPA-A-UC2 on DTI; 

2. Invoke PIP, as 

$R\m DTj2f:PIP.16K 
PIP-llVxx 

3. Specify the following command string to PIP: 

#_DC : < DTI : GOTAl 6 . DC 

Dismount DEC-11-0CSPA-A-UC2 , and mount and WRITE ENABLE a back-up 
DECtape on DTI. The UIC [1,1] must be entered on the back-up DECtape, 
which is done by the PIP command: 

f DTI : /EN 

4. Kill PIP: 

#tc 

_^KI 

5. Enter the BATCH command, as: 

$BA GOTAl 6. DC 

6. In the course of processing, two messages will be 
printed at the keyboard. The first is: 

LINKSY: MOUNT DEC-11-OCSPA-A-UCl ON DTj2f : WRITE LOCK 
LINKSY:MOUNT BACK-UP DECTAPE ON DTI: WRITE ENABLE 
AJ3f5j2f }?j2fj2fj3fj?j2f 

Mount the indicated DECtapes, and type 

$C0 

The second message is: 

LINKSY: MOUNT DEC-11-0CSPA-A-UC2 ON DTI: WRITE LOCK 
Aj2(5jaf 00jli9l00 

After the back-up DECtape has been dismounted, and this 
DECtape mounted, type 

$C0 

The completion of processing is indicated by the print- 
out of a directory listing followed by: 

$FINISH 

TIME ; -XX : XX : XX (approximate duration =20 minutes) 

BATCH Vxx 
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2.2,3.2 DOS Procedures 



9 
10 



11, 



12 



Mount DEC-11-OCSPA-A-UCl on DTJ?: WRITE L0CK\ p^^^ ,,^^^ , ^ 
Mount Back-up DECTAPE on DTI: WRITE ENABLE / star ting ^^^^""^ 
$RUN DT:LINK0B.12K 

$RUN DT:PIP.16K 

FdC: <DT ixMACRO. OBJ, PST. OBJ 

lie 
^KI 

$RUN DT:LINK.12K 
#PC:<MACR0,PST/E 

#tc 

^KI 

$.RUN DT:PIP,16K 

|DT1 : <MACRO. LDA/SU 

#MACRO . OBJ , PST . OBJ , MACRO . LDA/DE 

f DC : <DT : PIP . OBJ , PIP0V)2( . OBJ, PIPOVl . OBJ NOTE 

fDC : <DT: PIP0V2 . OBJ , PIP0V3 . OBJ 

ffC 

^KI 

$RU DT:LINK.12K 
£DC: <PIP/CC/OV: 4/E 
#pC:<PIP0Vj2f/CC/E 
£DC:<PIP0V1/E 
ipC: <PIP0V2/CC/E 
#pC:<PIP0V3/E 

#tc 

^KI 

$RU PIP 

£* . OB J/DE 

£DC : <DT : LINK . OBJ , LINKOB . OBJ 

$_RU DT:LINK.12K 

#pC:<LINK/E 

#DC:<LINKOB/E 

ffC 

.KI 



$_RU LINKOB 

$RU PIP 

#LINKOB . */DE , LINK . OBJ 
Mount DEC-11-0CSPA-A-UC2 
#DC: <DT1: * . OB J 

ftc 

_^KI 

$_RU LINK 

#pC: <CILUS/CC/OV: 4/E 

£CILUSj2f .OVR<CILUS0/E 

iCILUSl . 0VR<CILUS1/E 

#CILUS2 . 0VR<CILUS2/E 

#CILUS3 . 0VR<CILUS3/CC/E 

|fC 

^KI 

$RU PIP 

£* . OB J/DE 

£DC : < DT : EDIT . OBJ , CREF . OBJ 

£fc 

.KI 



The procedures shown here are 
for 16K configurations . For 
8K configurations, use LINK.8K, 
LINKOB. 8K, and SPIP.8K. Copy 
LINKOB. 8K to disk, run it from 
disk, and delete it after use. 
At step 3, for the transfer com- 
mand, use: 

£DC : <DT : MACROP . OBJ , P STP , OBJ , MACOVR . OBJ 

At step 4, for the transfer command, 
use: 

#DC : <DT : MACROP . OBJ , PSTP . OBJ , MACOVR . OB J/E 

For 12K systems, use LINK.12K, 
LINKOB. 12K (as shown), and PIP.12K 
(instead of PIP.16K). At step 3, 
for the transfer command, use: 

£DC : <DT : MACRO . OBJ , PST . OBJ , MACOVR. OBJ 

At Step 4, for the transfer command, 
use: 

\ £DC : <DT : MACRO . OBJ , PST . OBJ , MACOVR. OB J/E 
on DTI: WRITE LOCK 
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13. _$RU LINK 
£DC:<EDIT/E 
£DC:<CREF/E 

#tc 

14. _$RU PIP 
#*.OBJ/DE 

_|DC: <DT : LIBR. OBJ , FILDMP . OBJ 

#tc 

^KI 

15. $RU LINK 
£DC:<FILDMP/T:3 746i2f/E 
JDC:<LIBR/E 

_^KI 

16. _$RU PIP 
J*.OBJ/DE 

£DC : ODT . OB J< DT : ODTl IR . OBJ 
#DC:/DI 



2.3 BACKUP PROCEDURES 

2.3.1 Use of ROLLIN 

The ROLLIN utility program, if available, can be used to dump 
the system disk to a backup storage device (magnetic tape, DECtape 
or on an alternate RKll disk). The procedure is: 



1. Load and start ROLLIN (see Chapter 4 of the ROLLIN 
manual for these procedures) . 

2. For DECtape backup, specify: 

#_DT0:<disk: 

where disk: is DK0: , DP:, or DC:, for RKll, RFll, 
or RCll, respectively. The number of DECtapes 
required to back-up the disk varies: 10 DECtapes 
are needed for a 2200 bpi RKll cartridge. 

3. For magnetic tape backup, specify: 

£MT0: f ilename<disk: 

where a file name (e.g., SYSFIL) is assigned to the 
backup copy, and disk: is specified as DK0: , DF:, 
or DC: . 

4. For an alternate RKll cartridge, specify: 

#DK1:<DK0: 
The entire contents of DK0: are copied to DKl: . 
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Restoring the system is done by reversing the order of the 
command string, e.g. ; 

£DK0 : < DT0 : 

or 
£DK0 : <MTi3 : SYSFIL/FIND 

The /FIND switch and operating procedures are described in the 
document PDP-11 ROLLIN UTILITY PROGRAM ^ DEC-11-ORDAA-A-D. To 
obtain ROLLIN, order either DEC-11-OROLA-A-PB (paper tape) , or 
DEC-11-OROLA-A-UB (DECtape) from the Software Distribution Center, 
Main St., Maynard Mass. 

2.3.2 Use of PIP 

The PIP file utility program can be used to store backup copies 
of specific programs; for example, the load module form of MACRO 
can be backed up on DECtape by running PIP, and specifying the 
command string: 

£DT0 : <MACRO . LDA/ FB 
To copy most system files, specify the command 

#DT0:<*.LDA[1,1] 

Files not copied as a result of this command may be copied 
individually . 



NOTE 



^v-L.JLJ h^J.^J.^w' UJ. J.fU. IlOf U. i-'C 



MOATT Tt* r»TT ^Vi , 

J.-J.Vyj.M J_1JL J^ • \^-L.XJ h7J..J.V 

is backed up on the distribution medium 
as MONLIB.LCL, and must be reloaded by 
SYSLOD. 



The copies can be restored to the disk by the PIP command 
string: 

#SY:<DTJ3f: *.LDA/FB 
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2.3.3 Reloading the System Disk 

Should it be necessary to reload the system disk, the method 
used depends on whether ROLLIN was used to back up the disk. If it 
was, ROLLIN can be used to restore the disk. Follow the procedures 
described in the ROLLIN document, pertinent to the medium used to 
back up the system disk. 

If ROLLIN was not used, the Monitor must be reloaded according 
to the procedures in section 2.1. Then, PIP can be used to copy 
backup versions of system files to the disk. If no backup versions 
were created, follow the procedures in section 2.2. If the backup 
medium (e.g., DECtape j2f) contains only system files, the following 
command to PIP can be used: 

£dev:<DT0:*.*[l,l] 

2.4 USING SYSLOD WITH AN EXISTING SYS TEM DISK 

A Vj2(8 Monitor (BATCH or DOS) can be installed on an existing 
system disk by following the general procedures outlined below: 

1. Put all files on a backup medium (e.g., DECtape or 
magnetic tape) , via PIP; 

2. Load the system, as described in sections 2.1 and 
2.2; 

3. Use PIP to copy files from the backup medium to 
disk. 



2.5 ENTERING UIC'S 

After the system is installed, and system programs are loaded, 
the System Manager should enter his user identification codes. This 
procedure is described in Chapter 6. 
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CHAPTER 3 

MONITOR MODIFICATION 

3.1 INTRODUCTION 

When a BATCH-11 or DOS-11 Monitor is loaded, it is initialized. 

initialization routine is run, which establishes the conditions in 
which the Monitor will operate. It does this by examining a module 
in the Monitor, called the Configuration Module. Each Monitor 
contains a standard version of the Configuration Module, which appears 
in Appendix E. Other standard components of each Monitor include: 

Resident Monitor (RMON) 
Keyboard command routine 
Device drivers 
EMT routines 
Clock routines 
Transient monitor 

The Configuration Module is the means by which the user modifies the 
system to his special needs. He may add, replace, or delete device 
drivers, or EMT routines. The Configuration Module is the medium 
through which he communicates such changes to the Monitor. 



The remainder of this Chapter describes the method of modify- 
ing the Configuration Module. Adding, replacing and deleting system 
facilities (drivers, etc.) are described in Chapter 4. 

3.2 BUIIxDING THE CONFIGURATION MODULE 

The Configuration Module (CFTBL) is assembled using three 
source files: 

1. CFMAC.MAC A set of macro definitions. 

2. SYSTEM. MAC A file that defines the system. SYSTEM. MAC 

is edited to reflect configuration changes. 
(Refer to section 3.3.) 

3. CONFIG. MAC A file of macro calls and macro directives 

that create the Configuration Module in 
object form. 
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The procedure is: 

$_RUN MACRO 

MACRO V xx 

#_CFTBL . OBJ , LP : /LI : ME/CRF<CFMAC . MAC , SYSTEM . MAC , CONFIG . MAC 

NOTE 

For users with 8K configurations, DEC has sup- 
plied the MACROS. LDA load module, which is used 
to assemble these source files. The appropriate 
command is $RUN MACROS. LDA. 
3.3 EDITING SYSTEM. MAC 

When a configuration is modified, the source file SYSTEM. MAC 
must be edited, and the Configuration Module re-assembled to re- 
flect the changes. 

Editing can be performed on the following elements in SYSTEM. MAC: 

Symbol 



1. 
2. 

3. 

4. 



Default UIC 
Clocks 

Standard devices 
User-defined EMT's 



DFU 

FTCLL 

FTCLP 

FTxx 



UDEMT 

UDEMSW 

UDEMRS 

GEMU0 

-GEMU5 

GLOTAB 



Highest EMT number -77 



8' 



5. 



User-defined (non-standard) 
devices 



No. of swappable EMT's; 

No. of resident EMT's; 

Macros used to specify 

EMT ' s ; 

Definition of globals that 

cause EMT's to be loaded 

by the Linker. 
UDDEV Total of user-written 

device handlers 
GDVU0 Macros used to define 
-GDVU2 devices. 



The following sections are pertinent to the comments included in 
the listing of SYSTEM. MAC. Refer to Appendix E. 

3.3.1 Default UIC Value 

The system default UIC (User Identification Code) is used when 
no UIC is specified on a Batch job. All files created during pro- 
cessing of the job are put into the default UIC area. The standard 
default UIC is [1,2]; i.e., project no. 1, user no. 2. To change 
this (e.g., to [0,0]) , edit the line in SYSTEM. MAC that reads: 

DFU 1,2 
Change the values of 1,2 to those desired, e.g.. 



DFU 



0,0 
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NOTE 

By specifying 0,0 as the default UIC, you prevent 
Batch jobs from being run if they omit an author- 
ized UIC on the JOB card. The standard default 
UIC [1/2] is entered by SYSLOD when the BATCH-11 
Monitor is loaded. 



3.3.2 Clock Routine Definition 



The lines 



FTCLL=1 
FTCLP=1 



define the line frequency clock (KWll-L) and programmable clock 
(KWll-P) , respectively. In its unmodified state, SYSTEM. MAC uses 
the following rules to determine which clock routine will be loaded: 

1. If no clock is present, no clock routine will be loaded. 

2. If tv/o clocks are ^-iresent, the KWll-L clock routine 
will be loaded. 

3. When one clock is present, the corresponding clock rou- 
tine will be loaded. 

To prevent a clock routine from being loaded, even though the 
corresponding clock is present, delete the appropriate line from 
SYSTEM. MAC. For example, to prevent the line clock from being loaded, 
delete the line: 

FTCLL=1 
3.3.3 Standard Devices 

Standard devices are defined by symbols in the form FTxx where 
XX corresponds to the device mnemonic. To ignore an existing device, 
simply delete the corresponding FTxx=l symbol. 

E.g., to omit magnetic tape, delete the line: 
FTMT=1 
This might be done to omit a device that is malfunctioning. 
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3.3.4 User-Written EMT's 

User-written EMT's are defined starting with the variable 
UDEMT=n, where n equals the maximum user-written EMT value, minus 77g' 
That is, if six user-written EMT's have been added, the highest of 
which is EM. 154, the value of n is 55g (154g-77g) . When no EMT's 
have been added, n equals 0. Note that n can range from 41g to 70 g. 
User EMT's must be in the range 140 „ to 177g. 

The next variable, UDEMSW=n, defines the number of swappable 
user-written EMT's, i.e., the number of EMT's that are loaded 
when needed. 

The variable UDEMRS=n defines the number of user-written EMT's 
to be made resident, i.e., EMT's that are loaded at system initiali- 
zation time and remain in core whether in use or not. 



After the three UDEMxx=n variables are defined, specify all 
user-written EMT's in macros GEMUj2f to GEMU5 , as follows: 

1. Specify swappable EMT's first; 

2. After all swappable EMT's are specified, start speci- 
fying resident EMT's in a new macro; 

3. Specify 13g EMT's per macro (or the remainder if less 
than 13 remain to be specified) ; 

4. EMT specifications must begin with macro GEMU0, and 
the sequence GEMU0, GEMUl. . .GEMU5 must be followed. 
No macros may be skipped; 

5. Specify EMT's by replacing the line .IRP < > 

with a line including the user-written EMT numbers; 
e.g. , 

.IRP P,<141,142,143,144,146,151,152,153,154,160,161> 

6. User-written EMT's must be added to the GIL. (Refer 
to Chapter 4, Section 4.2.1). 
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3.3.5 Non-standard Devices 

The system configuration module can be modified to include 
non-standard devices as follows: 

1. Define variable UDDEV=n, where n equals the number of 
non-standard devices- User-defined drivers for these 
devices should be in the Monitor CIL (refer to Chapter 
4) . 

2. Non-standard devices are defined in the macros GDVUj? 
to GDVU2. 

3. Three devices may be defined per macro. To add more 
than nine, add macros named GDVU3, GDVU4 , . . . etc., in 
the format of GDVUi2f. 

4. Macros should be used in sequence, without skipping. 
.Tiiv^ii >_j.ij.fcii5 v^j. iiiwic i-icvxt^co j.c:iLLci.xj.i. uu Dt; ufciJ-xntiQ, tnxee 
should be defined in the current macro. 

5. A non-standard device definition has the general format: 

<X,IV> 

where X = the device m.nem.onic, and, 
IV = interrupt vector address. 

A full device macro definition has the general format: 

. IRP P , <<X1 , IV1> , <X2 , IV2> , <X3 , IV3>> 

3.3.6 Configuration Title 

To help the user keep track of the configuration his system is 
using, a title can be assigned in the Configuration Module. This is 
done by inserting text between the angle brackets (< >) on the line 
reading: 

"TrMT'ikTrn ^ ^ 
XUJLlVi ± ^ ^ 



For example, the line could be edited to read 

IDENT <RK,NO RF> 

When the Monitor identifies itself it also prints the Configura- 
tion Title; e.g.: 

RK,NO RF 
DOS V08 

$ 
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3.3.7 Steps in Modifying the Configuration Module 

Figure 3-1 illustrates the flow of procedures used to update the 
Configuration Module. Each step is numbered. The coininand strings for 
each step are shown on the page following Figure 3-1 (section 3.3.8), 
headed by the corresponding number. If the files needed by step N are 
available, processing may begin at step N. That is, if the files 
RMON.LDA, CFTBL.LDA, TAIL.LDA, and USER.LDA are available (steps 1 to 3), 
processing can start at step 4 . 



The symbols in Figure 3-1 are interpreted as follows: 



© 



( AAA ) - 



AAA 



\ _ 




An entry point at which processing can 
begin, if processing for all prior 
entry points is complete. 

A DEC-supplied module. 

A user-supplied, or modified module 

A BATCH/DOS-11 System Program 



Figure 3-1 is formatted to assist in choosing a starting point 
and to illustrate the order in which input files must be specified. 
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BYSTEM.MAQ 




CFTBL.LDA TAIL.LDA . USER.LDA .' 



USER-SUPPLIED 
[CONCATENATED] 
LOAD MODULES 



^MONLIB.CIL^; '^MONLIB.LCL 



CILUS 
BOOT 
OPERATION 



( monlib.cilI 



Q> 



cilus 

HOOK 

OPERATION 



NOTE: The left-to-right order of input files corresponds 
to their correct sequence in the command string to 
the system program. 



Figure 3-1 Overview of Monitor Initialization 
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3.3.8 Monitor Initialization Command Strings 



1. Editing SYSTEM. MAC 

£RUN EDIT 

#_S YSTEM. MAC <dev: SYSTEM. MAC 

*R 

(perform edits) 

*EX 

2. Assembly of Configuration Module (CFTBL) 

$_RUN MACRO ; MACROS. LDA FOR 8K SYSTEMS 
#CFTBL , LP : /LI : ME/CRF<CFMAC , SYSTEM , CONFIG 



3. Linking CFTBL 

£RUN LINK 

#CFTBL , LP : < RMON . STB , CFTBL/B : 0/E 



4. Building Monitor CIL 

a. With no user-supplied modules 

$_RUN CILUS 

|NEWMON . C IL , LP : , SY : NEWMON . LCL< RMON/BU , CFTBL , TAIL/E 

b. With user-supplied modules 

£RUN CILUS 

iNEWMON . C IL , LP : , SY : NEWMON . LCL< RMON/BU , CFTBL , TAIL , USER/E 



All user-supplied modules should be 
concatenated in a file named USER. LDA. 



5. Booting the Monitor CIL 

$RUN CILUS 
£NEWMON.CIL/BO 

The HOOK operation should not be per- 
formed until the new Monitor is checked out, 

NOTE 



A FINISH command reinitializes the Monitor, 
which has the following consequences: 

1. If the bootstrap on the system 
device is not a Vj2f8 bootstrap, 
the system crashes. The boot- 
strap must be a V08 bootstrap. 
Old bootstraps are not compatible. 

2. A FINISH command reloads the sys- 
tem that is hooked to the system 
device. 
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First initialization procedure - Notes 

a. Respond to line frequency question 

b. Do not HALT manually until 

DOS vers batch v0b 

I o^ I 

is printed. 
6. Hooking the CIL 

$RUN CILUS 

#NEWMON . CIL/HOOK/TO : 8 

~ NOTE 

The /TO: 8 switch allows the Monitor to be used on mach- 
ines of 8K core memory and above. This switch should 
be used when hooking the CIL. 

3.4 CAUTIONS 



The following points should be noted: 

1. The first bootstrapping of a newly- created system should 
not be interrupted, because the CIL is in the process of 
being modified. This process occurs between the start 
of the read, and the Monitor's printout of its identifi- 
cation. This caution does not apply to subsequent boot- 
strapping of the system. 

2. Do not use PIP to transfer CIL's. The recommended pro- 
cedure is to create a LICIL version of the file, which 
can then be transferred by PIP. 

3. The hardware configuration need not be exactly configured 
because the initialization routine selects those devices 
that are defined in the Configuration Module which are 
also present in the configuration. Thus, DEC cartridges 
on RKll controllers can be exchanged between machines, 
when the configuration has been defined as having all 
possible peripherals, and the initialization routine will 
select only those devices actually present. 

4. If two clocks are defined and both are installed (KWll-P 
and KWll-L) , the KWll-L will be selected. Otherwise, the 
existing clock will be selected. 



Table 3-1 lists errors that may occur when the system is first 
loaded. Error messages are printed at the keyboard, with the fol- 
lowing additional text: 



CIL IS WRONG. CHECK ERROR LIST. REBUILD CIL 
AFTER CORRECTING ERROR, AND TRY AGAIN. 
SYSTEM WILL HALT NOW; LOAD A BACKUP SYSTEM. 

Because the system is not yet loaded, normal error processing 
cannot be performed. 
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TABLE 3-1 
Initial System Load Errors 



ERROR 
MESSAGE 


CAUSE 


CILERR 


The format of the CIL index is not right. A high- 
order byte of a binary file was not equal to 0. 
Check CIL index and recreate CIL. 


SPCERR 


Core size is insufficient to initialize a system. 
Notify a DEC Software Specialist. 


CL3ERR 


No CIL line with code 3 has been found in the 
General Information CIL line. Rebuild the CIL. 


CLCERR 


The CIL lacks a module required by the defined con- 
figuration. The module type can be determined by 
examining R3: 




R3 = 4 
R3 = 3 
R3 = 2 
R3 = 1 


EMT module 
Keyboard module 
Driver module 
Clock module 




To determine the total number of missing modules, 
check the memory address referenced by the contents 
of R4 minus 2. 


DSZERR 


The disk block size does not equal either 100 „ or 

400o, according to the Bootstrap, 
o 


CORERR 


The nonexistent memory loop did not detect nonexis- 
tent memory. Call Field Service. 


MRTERR 


The format of MRT in the CFTBL file is wrong. 


DXIERR 


The format of KB.DXl (keyboard module index) is 




wrong. 


SPEERR 


EMT's defined as special in CFTBL are not known as 
special by RM0N5. May create compatibility prob- 
lems. 


SQZERR 


A keyboard module had more than nine overlays. 


CSQERR 


Sequence verification error. Successive CIL mem- 
bers should be on successive CIL blocks. (The 
CIL block number should be a monotonic increasing 
function of the CIL sequence number.) 


SEQERR 


A keyboard module has its overlays in disarray. 
Recreate the CIL. 
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Initial System Load Errors (Cont.) 



ERROR 
MESSAGE 



CAUSE 



CFTERR The module named CF.TBL should be the second module 
in the CIL. This error results from using an incor- 
rect CILUS command when replacing CF.TBL. 

KBCERR Keyboard module not found in Table DXl. 

MODERR One of the following essential modules is not in the 
CIL: 

KBI 

XIT 

EM77 

KBDXl 

KILL 

TMON 

SYSERR The bootstrap device is not recognized as a valid 
I system device by the initialization code. 

■-■ ■ - II I I II I I II ■ I. ■ IN I 

The recommended procedure in the event an initialization error 
occurs, while installing the standard DEC Monitor, is to contact a 
DEC Software Specialist. 

3.5 MONITOR MODULE RESIDENCY NOTES 



The following points should be noted when deciding to make Monitor 
modules resident: 



Any transient module can be made resident. A transient 
module is any module which uses the main swap buffer, in- 
cluding all modules that service programmed monitor re- 
quests. (The exception is RWN. , which serves .READ and 
.WRITE requests, and is always resident.) 

Device drivers should not be made resident, because they 
are resident from .INIT to .RLSE. 

Keyboard command modules may not be made resident. 

GNM and EDP may not be made resident. GNM is the global 
name of a subsidiary routine used by the RWN module. 
The RWN module processes .READ and .WRITE requests, and 
is permanently resident. EDP is the Error Diagnostic 
Print routine. 

When a transient module is made resident, any siibsidiary 
routines should also be made resident. Otherwise, swap 
buffer conflicts may occur at interrupt time. Subsidiary 
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routines are defined in Appendix C of the DOS Monitor 
Programmer's Reference Manual, DEC-11-OMONA-A-D. 

If a non-reentrant module is made resident, the user 
must ensure that it is not reentered prematurely, by 
issuing a .WAIT prior to its subsequent usage. Note 
that modules that are non- reentrant simply because they 
have overlays are exceptions, since making them resident 
(along with their overlays) removes the problem. (The 
RLS. module should never be made resident, in any case.) 

A reentrant module is one that can be recalled to proc- 
ess a second request before it has finished processing 
the first request. For example, the BLO module might 
be called to initiate data transfer, and return immedi- 
ately to the user. It could then be called again before 
the first data transfer was finished. A transient rou- 
tine is not reentrant if either of the following condi- 
tions applies: 

1. It calls the routines that get and release 
buffer space (S.GTB, S.RLB); 

2. It has overlays, or calls subsidiary routines. 

Routines that call S.GTB and S.RLB are summarized in 
Tc±)le 3-2. Subsidiary routines are described in Appen- 
dix C of the DOS Monitor Manual. The . INIT 
processor (INR) has an overlay, but it is automatically 
loaded if INR is made resident. 



Table 3-2 



Modules That Call S.GTB and S.RLB 



Module 


Function 


ALO 


Allocate 


APP 


Append 


CBA 


Allocate contiguous blocks 


CKX 


Check access privileges 


CLS 


Common CLOSE Processor 


DCN 


Delete contiguous files 


DEL 


Set-up procedure for Delete 


DIR 


Directory search 


DLN 


Delete linked files 


FCL 


Close a file 


FCR 


Create a file 


FOP 


Open a file 


GMA 


Transfer bit-map to/from core 


INR 


INIT processor 


LBA 


Allocate blocks to linked files 


OPN 


Common OPEN Processor 


PRO 


Set file protection 


RNM 


Rename a file 


RUN 


Process RUN EMT 
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CHAPTER 4 



SYSTEM FACILITIES 



4.1 DEVICE DRIVERS 

The BATCH/DOS— 11 systeni includes standard versions of the fol- 
lowing device drivers : 

Driver Device 

DV.CR CRll/CMll Card Reader/Mark Sense Reader 
(assembled for ASCII only) . 

DV.LP LPll Line Printer (assembled for 80 columns). 

DV.MT TU10 Ma'^netic Ta'^e (v/ith automatic rewinds^. 

DV.QT TUljEf Magnetic Tape (without automatic rewinds) . 

DV*DC RCll Disk. 

DV.DF RFll Disk. 

DV.DK High-density RKll Disk (assumes all units high 
density) or low-density RKll Disk (assumes 
unit low density) , 

DV.DT DEC tape. 

DV.KB Console Teleprinter. 

DV.PR Paper Tape reader. 

DV.PP Paper Tape punch. 

4.1.1 Naming Convention for Device Drivers 

The convention established for device driver modules is to use 
a TITLE statement of the following torm: 

.TITLE DV.xx 

where xx is the name of the driver. E.g., 

.TITLE DV.LP 

is the name of the LPll Line Printer driver. If the user writes a 

driver for a non-standard device (e.g., QC) , he must observe this 

convention. That is, the driver (in this case) must have the fol- 
lowing title: 

.TITLE DV.QC 
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The drivers have been written by DEC to function in certain 
ways, as defined in the Device Driver write-ups (DEC-11-NIZA-D and 
supplements). Through the use of optional assembly parameters, the 
user can alter the manner in which some of these drivers function. 
Table 4-1 summarizes the drivers that can be modified, and the 
assembly parameters that apply tb each. 

Optional assembly parameters are specified for one of two 
reasons : 

1. To reduce the size of the device driver; or, 

2. To increase or alter the driver's capabilities. 

4.1.2 Assembling Device Drivers 

When the assembly parameters have been decided upon, it is neces- 
sary to assemble the driver, including the parameters. One method of 
doing this is to edit the source program, specifying the parameters 
there. A simpler method is to specify the parameters at the Keyboard, 
following input of the MACRO command string as shown in the following 
example: 

$RUN MACRO 

MACRO Vn XX 

#CR,LP:/CRF<KB:/PA:1,SY:CR 

ONLY29=J2f 

+C 

.END (two carriage returns, or carriage return, line feed) 



±n the preceding example, the user has specified that the Card 
Reader driver be assembled, with input coming from the keyboard and 
the file CR.MAC. The keyboard input, which is read only during Pass 1 
(/PA:1), follows on the succeeding line: 



ONLY29=j3f indicates that cards are to be read in 
J?29 mode only; ^26 control cards will 
be ignored. 



The fC .END sequence signals the end of keyboard input. In- 
put is now read from the system disk, as file name CR.MAC or CR.PAL. 

This method of specifying assembly parameters for device drivers 
is recommended, because it precludes the possibility of errors that 
may occur in editing the driver source. 
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DEVICE DRIVER PARAMETERS 



Driver 



Parameter 



Function 



BINARY=j2f 

DEFALT=0 ') 
ONLY26=0 [ 
0NLY29=J3 ) 



DV.LP LP11=132. This parameter defines the number of print 

columns, in decimal. LP11=80. is the default. 

DV.CR BLANKS=i2f This parameter enables the blank suppress option. 

When enabled, a blank suppress card causes columns 

73-80, and any trailing blanks to be ignored on _ 
j following data cards, and to be replaced by CR/'Lf. 

A second blank suppress card in the deck disables 
I the option. This parameter is included in the 
J standard Card Reader driver distributed by DEC. 
'To eliminate this, the driver must be re-assembled, 

with BLANKS=0 deleted. 

This parameter enables the reading of binary 
data, as well as ASCII. 

This group of parameters defines the card 
codes accepted. Normally, either 026 or 
029 cards may be read, where 029 is assumed 
by default if no 026 control card is present. 
DEFALT reverses this, to make 026 the de- 
fault value. ONLY26 and ONLY29 restrict 
the driver to one or the other. 

MARKS=0 ^The Card Reader driver, in standard form, 
iwill read either 80-column punched cards, 
,or 40-column CMll Mark Sense cards. Speci- 
^fying MARKS=0 restricts the driver to 40- 
column cards. 

DV.DK LOWDEN=0 This parameter specifies that all RKll 

drives are low density and causes creation of 
DV.DKL. (If no parameter is specified, all RKll 
drives are assumed to be high density.) 

These two parameters define a system hav- 
ing RKll drives of mixed density, some high, 
some low and causes creation of DV.DKH. The 
value of N defines those having low density, by 
matching bits against unit numbers. N=112p is 
01001010^; thus units 1, 3, and 6 are low density 
(bit bSing the rightmost bit) . These parameters 
must be used together, 

DV.MT DVRRWD=0 This parameter eliminates the rewind function. 

When defined, no rewinds occur, and the driver 
name is changed to DV.QT. The QT version is 
used when DV.QT is specified as the driver 
name rather than DV.MT. 

Under normal circumstances, magnetic tape is 
rewound with each .OPEN and each .CLOSE, which 
can be time-consuming. It may be useful to 
have both versions of the driver available, 
affording a choice based on the most appropri- 
ate for the circiomstances. Both versions are 
included in the distributed system. I 

1 NOTE 

The conditional assembly parameter SYSDV, formerly 
included for disk drivers, is no longer used. 



MIXED=0 
CONFIG=N 
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To change the Line Printer driver (DV.LP) to accommodate 132- 
column lines, assemble the driver, specifying the following commands: 

$_RUN MACRO 

MACRO Vn XX 

£LP,LP:/CRF<KB : /PA : 1 , SY : LP 

LPll = 132. 

+C 

.END (terminate the END command with either two carriage 

~ returns, or carriage return, line feed). 

4.1.3 Adding Device Drivers 

To add a device driver, the procedure outlined in steps 1 
through 5 below must be observed. It is also necessary to observe 
the device driver naming convention, as defined in section 4.1.1 

Steps in adding a driver: 

1. Create the driver source (s), with reference to the 
document PDP-11 Device Driver Package (DEC-11-NIZB-D) . 

2. Assemble the edited source module(s), e.g., 

$_RUN MACRO 

MACRO Vxx 

#DVR1,LP: <DT0:DVR1 (the source program must 

#DVR2,LP:<DT0:DVR2 be correctly titled. I.e., 

DV.DT, for a DECtape driver.) 

3. Link the assembled object module(s), as: 

$_RUN LINK 

LINK Vxx 

£DVR1,LP:<DVR1/B:0/E (a bottom value of is required) 

|_DVR2 , LP : <DVR2/B : 0/E 

4. Use PIP to concatenate the driver modules (optional) : 

$_RUN PIP 

PIP Vxx 

#USER . LDA< DVRl . LDA , DVR2 . LDA 

5. Update the Monitor CIL, as: 

$_RUN CILUS 

CILUS Vxx 

£NEWMON/BOOT , , NEWMON . LCL<MONLIB . LCL , USER . LDA/E 

^I DT:DVR1,DVR2 (I is the Insert command) 

*E 

The two USER. LDA modules (DVR1,DVR2) are inserted into the 
Monitor CIL ahead of the DECtape driver module (DT) . 
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NOTE 

To determine the order of modules in the 
Monitor, run CILUS , specifying the follow- 
ing command string: 

#_LP : < NEWMON . CIL/LIST 
Note that the output CIL has been named NEWMON. This name is 

__„^ „„ J j.^ ji ^^ ^ ».,-,»-,+. T Ei4-- 4~V-.-. C-- tr- v-c> -i ,— ,r-. .".-f -i-ViCi M.—.t-. T ■J-.'-.r- ^TT ■fy-nm ^"h.i^ 
ass i>^ii.Sv-i i->.^ dii iSj-dl t- J- Ci^vi T_liiti Vtil. S i'— 'Xi w^ '—iiC i'i'-^'li^ ■_■— .■!. 1 — ■-.:-: ^ i ■_■!:: ^ii_ 

currently checked out version (MONLIB.CIL) . The new version should be 
thoroughly tested before it is named MONLIB.CIL and hooked to the 
bootstrap. (Any user-created name may be assigned; NEWMON is 
merely an example.) 



4.1.4 Deleting Drivers 

To delete a device driver, run CILUS, specifying the 
Delete command. For example, to delete the RFll disk driver; 



$_RUN CILUS 

CILUS Vxx 

£NEWKON.CIL/BO , LP : , SY : NEWMON . LCL<DT1 : MONLIB . LCL/E 

*D DV.DF (D is the Delete command) 

*_E 

The Configuration Module must be edited and re-assembled to 
reflect the modified configuration. Refer to section 3.3.3, and 
Figure 3-1. 

4.1.5 Replacing Drivers 

To replace a device driver, observe the following procedures 

1. Assemble and link the replacement driver. 

2. Create a concatenated file of load modules (e.g., 
USER) containing the new driver. 

3. Run CILUS, specifying the R edit command: 

$_RUN CILUS 
CILUS Vxx 

#NEWMON.CIL , , NEWMON . LCL <MONLIB . LCL , USER . LDA/E 
fR DV.XX:DV.XX (R is the Replace command) 
*E 

The version of DV.XX in the Monitor CIL is replaced 
by the version of DV.XX from USER.LDA, 
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4.2 EMT MODULES 
4.2.1 Adding EMT's 

User-written EMT's can be added as follows: 

1. Refer to the DOS Monitor System Programmer's Manual ^ 
(DEC-11-MNDA-D) for details on writing EMT routines. 

2. Create the source module, observing the EMT naming 
convention in the .TITLE directive; viz: 

.TITLE EM.NNN 

where NNN is a value from 1^0^ to 167_. 

o 8 

3. Use PIP to concatenate user-written EMT's into a 
file named USER.LDA. 

4. Update the Configuration Module (refer to section 
3.3.4, and Figure 3-1). 

5. Insert the EMT into the Monitor CIL: 

$_RUN CILUS 

CILUS VjZf04A 

£NEWMON , , NEWMON . LCL<RMON , USER . LDA/E 

#1 EM. 140 

*E 

In this example, the module EM. 140 is appended to the Resident 
Monitor (RMON) . 



4.2.2 Deleting EMT's 

EMT's must not be deleted, since this causes initialization 
errors. 

4.2.3 Replacing EMT's 
To replace an EMT: 

1. Create the source module, using the sam.e name as that 
of the version to be replaced; 

2. Assemble and link the modified module; 
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3. Run CILUS, using the Replace commana to edit the 
Monitor CIL: 

$RUN CILUS 

CILUS Vxx 

#NEWMON/BO , LP : , SY : NEWMON . LCL<DT1 zMONLIB . LCL , USER . LDA/E 

;^R EM. 140: EM. 140 (The current EM. 140 is replaced by the 

backup version, also named EM. 140, in 
*p secondary input dataset USER.LDA.) 



NOTE 



Some EMT's are built from overlays. 
This must be considered when EMT's 
are replaced. 
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CHAPTER 5 



BATCH- 11 CONSIDERATIONS 



5.1 INTRODUCTION 



-l-^i. X.Sw> J_ ±LL<U. L^^V^X 



^^O- C._l.liCxi W WV^ XLlClliCL^ -Cii^ 



a system that includes the Batch-11 Monitor. It may be necessary to 
modify standard Batch-11 parameters to fit a particular installation. 
For example, it may be desirable to output listings to a default device 
other than the line printer when using Batch concise commands. Or, it 
may be useful to modify the actions taken when a Batch job terminates, 
or to change the default User Identification Code to limit accessibility 
to the system. Methods for implementing these changes are described 
in this Chapter. 

5.2 CONCISE COMMAND PROCEDURE FILES 

The Batch Command Language contains a set of commands called con- 
cise commands (refer to section 1.2 of the PDP-11 Batch User's Guide ). 
Concise commands function by invoking associated procedures, which ex- 
pand the commands to perform the appropriate processing (e.g., compile, 
link, and execute a FORTRAN program). The expansion of the command 
depends on how much information has been supplied, in the form of in- 
put and output datasets. Certain of these commands provide defaults, 
allowing input and/or output datasets to be omitted. Default datasets 
are supplied by the BATCH system. 

The default output datasets for certain commands are summarized 
in Table 5-1. 

TABLE 5-1 
CONCISE COMMAND DEFAULT OUTPUT DEVICES 



Command 


Dataset 


Default Output Device 


$EXECUTE 


Listing 


Line Printer 


$FORTRN 


Listing 


Line Printer 


$LINK 


Load map 


Line Printer 


$MACRO 


Listing 


Line Printer 


$DIR 


Output 


Line Printer 


$LIST 


Output 


Line Printer 
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To change the default dataset (or to eliminate it altogether) , 
the Concise Command procedure files must be edited. The source to 
be edited is named CMDS.MAC. 

CMDS.MAC has in it the global symbol DELIST, which defines the 
default listing device. The default listing dataset is used only when 
the appropriate dataset specification is absent in one of the Concise 
Commands. A specified listing dataset overrides the default. Thus, 

$DIR TO KB: 

will list the directory on the teleprinter, regardless of the default 
listing dataset specification. In standard form, DFLIST consists of 

DFLIST: 

.BYTE 3 ;BYTE COUNT - 0=NO DEFAULT 
.ASCII 'LP:' ; SYSTEM DEFAULT DATASET 

As specified, the octal number associated with the .BYTE direc- 
tive tells the system to examine the next three characters to deter- 
mine the default listing dataset. In standard form, this is the line 
printer (LP:). This can be changed by editing the ASCII string to 
the desired value, and updating the byte count as needed. E.g.: 



DFLIST: 

. BYTE 3 
.ASCII 'KB:' 



In this example, the keyboard becom.es the default listing 
device. No adjustment to the byte count is needed. 

To eliminate the default listing device, change the byte count 
to 0} i.e., 

. BYTE 

The ASCII string following is now ignored. 



NOTE 



When the DFLIST byte count is set to 0, the 
MACRO control line must be edited to remove 
the /CR switch. 
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5.2.1 Assembling and Linking Edited Procedure Files 

After a CMOS. MAC is edited, it must be re-assembled and relinked 
as part of the BATCH-11 Transient Monitor (TMON) . Assembly is accomp- 
lished by running MACRO-11, with the following command string speci- 
fied: 

#CMDS , listing<CMDS 

The relinking process is performed by running the Link-11 
Linker, with the following command string specified: 

#TMON , load map<TMON , LKP , BATMAN , CCL , CMDS/B : j?/E 

The input files are: 

TMON - Current Transient Monitor 

LKP - File Structured Lookup (EMT 46) 
BATMAN - BATCH MANAGER 

CCL - Concise Command Language Processor 
CMDS - Command Procedure Files 

For these command strings, all inout and output files are assumed 
to be on the system disk. 

CILUS is now used to replace TMON in the Monitor CIL, as in 
the following example: 

$RUN CILUS 

CILUS Vxx (CILUS identifies itself) 

|_NEWMON . CIL/BO , LP : , SY : NEWMON . LCL<MONLIB . LCL , TMON/E 

^R TM:TM 

*E 

Note that in the example, the output CIL is named NEWMON. CIL 
to prevent its replacing the Monitor CIL currently on the system 
device. It is booted, but not hooked, since it still must be tested. 
Only after checking its performance and being satisfied that it runs 
properly should the user hook it to the bootstrap. 
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5.3 JOB TERMINATION PROCESSING 

Jobs are normally terminated when a $FINISH card (statement) 
is detected in the batch stream, though in some cases termination 
is effected by a fatal error, or by detection of the $JOB statement 
defining the start of the next job. When a job terminates, the 
Batch operating system performs certain tasks which may be classified 
as "clean-up" tasks. These tasks include: 

1. Deletion of files in the default UIC area (if the 
current UIC matches the default UIC) . 

2. Output of the error dump, if present; 

3. Printing the default log, if used; or, 

4. Any combination of the above. 



The Batch system invokes termination processing by means of 
a $CHANGE command, with a file specified according to the job's 
requirements; i.e., one file is specified if only default UIC pro- 
cessing is appropriate, a different file is specified if default 
UIC and dump processing are required, etc. The files summarized in 
Table 5-2 are invoked only when a job is terminated by a $FINISH 
statement. A default file (CLJ2f.SYS) may be invoked when termination 
occurs under the following conditions: the default UIC was used, and 
no SFINISH command was included. 

TABLE 5-2 

SYSTEM FILES FOR JOB TERMINATION 



File Name 


Function 


CLl.SYS 
CL2.SYS 
CL3.SYS 
CL4.SYS 
CL5.SYS 
CL6.SYS 
CL7.SYS 


Processes default UIC. 

Processes error dumps. 

Processes default UIC and error dumps. 

Processes default log. 

Processes default UIC and default log. 

Processes default log and error dumps. 

Processes error dumps, default UIC, 
and default log. 
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These files consist of commands which call the system programs 
(PIP or LDUMP) that perform the needed functions. All these files 
must reside in the [1,1] area on the system disk. 



5.3.1 CLl.SYS 



$; 




$; 




$RU]S 


f PIP 


#*.* 


7DE 


CL2. 


SYS 



CLl.SYS IS USED TO DELETE FILES FROM THE DEFAULT 
UIC DISK AREA. 



$; CL2.SYS IS USED TO FORMAT AND PRINT DUMPS. 

$GET LDUMP 

$AS BI:,6 

$BEGIN 

LP : <DMP . SYS [1,1] 

$KILL 



NOTE: The com-mand string to LDUMP does not begin with a 
# character. 



5.3.3 CL3.SYS 



$; 
$; 

$GET LDUMP 



CL3.SYS IS USED TO DELETE FILES FROM THE DEFAULT 
UIC DISK AREA, AND TO FORMAT AND PRINT DUMPS. 



$AS BI : , 6 

$BEGIN 

LP:<DMP.SYS[1,1] 

$KILL 

$RUN PIP 

#*.*/DE 



5.3.4 CL4.SYS 



$; 
$; 

$RUN PIP 
#LP: <CMO.SYS 



CL4.SYS IS USED TO PRINT THE DEFAULT LOG, 



5.3.5 CL5.SYS 



$; 
$; 

$RUN PIP 

#LP:<CMO.SYS 

#*.*/DE 



CL5.SYS IS USED TO DELETE FILES FROM THE DEFAULT 
UIC DISK AREA, AND TO PRINT THE DEFAULT LOG. 
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5.3.6 CL6.SYS 



$; 
$; 

$GET LDUMP 

$AS BI:,6 

$BEGIN 

LP:<DMP.SYS[1,1] 

$KILL 

$RUN PIP 

#LP:<CMO.SYS 



CL6.SYS IS USED TO FORMAT AND PRINT DUMPS, AND TO 
PRINT THE DEFAULT LOG. 



5.3.7 CL7.SYS 



$; 
$; 

$GET LDUMP 

$AS BI: ,6 

$BEGIN 

LP:<DMP.SYS[1,1] 

$KILL 

$RUN PIP 

#LP:<CMO.SYS 

#*.*/DE 



CL7.SYS IS USED TO DELETE FILES FROM THE DEFAULT 
UIC DISK AREA, TO FORMAT AND PRINT DUMPS, AND 
TO PRINT THE DEFAULT LOG. 



5.3.8 Default File (CL0.SYS) 

In the event that the $FINISH statement was omitted, or the 
appropriate file cannot be found, the only termination processing 
done is to delete all files in the default nic area, if necessary. 
A file named CL0.SYS normally duplicates CLl.SYS, and resides in the 
[1,1] area of the system disk. 

CL0.SYS consists of: 

$RUN PIP 
#*.*/DE 



NOTE 

Comment lines are not allowed in i^L^.SYS. 
is, a line such as 

;THIS IS CLjZf.SYS 

is not permitted. 



That 
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5.3.9 Editing Job Termination Files 

It will be noted that all job termination files that involve 
dumps or the default log, specify LP (line printer) as the listing 
device. For installations not having a line printer, these files 
must be edited to specify the appropriate device, such as the 
teleprinter. Using CL5.SYS as an example, the edited version might 
be: 

$; CL5.SYS IS USED TO DELETE FILE FROM THE DEFAULT 

$; UIC DISK AREA, AND TO PRINT THE DEFAULT LOG. 

$RUN PIP 

#KB:<CMO.SYS 

#*.*/DE 

The sam.e type of editing would be done to the output-on-error 
dump. To put an error dump on DECtapeJ?, for example, CL2.SYS would 
be altered to: 



$; CL2.SYS IS USED TO FORMAT AND PRINT DUMPS 

$GET LDUMP 

$AS BI: ,6 

$BEGIN 

DTj? : DMP<DMP , SYS [1,1] 

$KILL 



5.4 MODIFYING THE DEFAULT UIC 

The standard default UIC is [1,2]. This UIC is used when no 
UIC is specified in a $JOB statement. To prevent unauthorized users 
from running Batch jobs, or to ensure that jobs are run only when 
properly identified, the default UIC can be changed to [0^0]. This 
forces users to provide a UIC that is currently entered (see 

Chapter 6, "Entering UIC's"), since a job associated with a UIC of 

[0,0] will not be run. 



To modify the default UIC, the Configuration Module must be edited, 
in its source form, re-assembled and relinked. Refer to Chapter 3, 
section 3.3.1. 



5-7 



ITTm r- 



>>,niiim:ii^ o 



PIP SYSTEM MANAGEMENT FACILITIES 



6.1 PIP FUNCTIONS 

The System Manager is able to use the PIP File Utility Package 
to perform the following tasks : 

1. Manage User Identification Codes (UIC's); 

2. Manage files on disk and/or DEC tapes; 

3. Initialize devices. 

The System. Manager operates in restricted m.ode; 1*6.,- he is 
permitted to use the system in ways not allowed to other users. 
To enter restricted mode: 

1. Log in under UIC 1,1 

$L0 1,-1 

2. Run PIP 

$_RUN PIP 

PIP Vxx 

£ (enter the appropriate command string) 

Because the operating system does not have built-in hardware/ 
software protection, certain potentially dangerous functions have 
been isolated from the general user and are available in PIP in a 
restricted mode. That is, the user must be logged under UIC 1,1. 
Thus, the UIC 1,1 should be restricted for the system manager and 
persons whom he deems trustworthy. 



6.2 MANAGING UIC'S 

UIC Stands for User Identification Code. In order to operate 
under the BATCH/DOS-11 Monitor , the user must log in, and identify 
himself to the system. He does this by entering his UIC: 

$^L0 XXX , yyy 

where 
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XXX = an octal number representing the project identifica- 
tion; and, 

yyy = an octal number representing the programmer's identi- 
fication. 

WARNING 

through 10 and 377 are not legal project or 
programmer identifications and should not be 
assigned to the general user. 

NOTE 



Under the BATCH Monitor, a Batch job can 
run under the default UIC; i.e., a $JOB 
card will be accepted without a UIC. How- 
ever, a UIC must be included when logging 
in at the keyboard. 

Since it is the System Manager's responsibility to control the 
manner in which the system is used, the following capabilities are 
available to him: 

1. Listing UIC ' s ; 

2. Entering UIC ' s onto the system disk; and, 

3. Withdrawing UIC's. 

6.2.1 Listing UIC's (/UIC) 

A listing of all UIC's on a device is obtained by specifying 
a command string in the following general format: 

#_dev: /UIC where dev: comprises the appropriate 
device specifier. 

^or example, to list all UIC's on RKll unit 0, enter: 

#DK:/UIC 



SAMPLE LIST 
DK0: 

[ 1,1 ] 
[234,234] 
[ 35,1 ] 
[140,252] 
[ 1,2 ] 
[201,201] 
[200,200] 
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6.2.2 Entering UIC ' s (/EN ) 

The /EN switch is used to enter UIC's into the Master File 
Directory (MFD) of a device. One or more UIC's can be entered, 
as shown in the following example: 

£DK: [2j2f0,2i^l] , [15 1,36] /EN 

As the result of the above command strings, project 200, 
user 201; and project 151, user 36, are included as authorized 
UIC's in RKll unit 0's MFD. 

In the absence of an explicit UIC, the UIC of the current user 
is entered. I.e. , 

#DK:/EN 

causes UIC 1,1 to be entered (since the System Manager logs in 
under 1,1) . 

6.2.3 Withdrawing UIC's (/WD ) 

The System Manager may wish to withdraw a UIC, and its associ- 
ated files, from the MFD of a device. He does this by using the 
/WD switch, as shown: 

Example 1 . 

#DK0: [27,311]/WD 

Project number 27, programmer 311 is now no longer a recognized 
UIC on RKll unit •?, All files are deleted under 27 311 and that 
space is now free to be used for other user's files. 

Example 2 . 

#DK: [20j2r,200],[55,67]/WD 

The UIC's [200,200], and [55,67] are removed from the MFD of 
RKll unit 0. All files associated with these UIC's are also 
deleted from the disk. 
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Example 3 . 

#DK1: [2j2rj2f,*]/WD 

This example shows the use of the asterisk (*) to indicate "all". 
The UIC specification is interpreted as user group 2j?j?, all users. 
PIP withdraws all UIC's in user group 2J?0 from the MFD on RKll unit 1 

6.3 FILE MANAGEMENT 

System Manager file management functions include: 

1. Listing file directories; 

2. Deleting files; 

3. Transferring files from one device to another; and, 

4. Superseding files. 

6.3.1 Listing File Directories (/PI) 

The PIP /DI (Directory) switch is used to list file directories. 
Directories can be listed in a number of ways, as illustrated in the 
following examples. 

Exam.ple 1 . 

£LP:<DK: [*,*]/DI 

All directories on RKll unit are listed on the line printer. 

NOTE 



Although the line printer (LP:) is specified 
as the listing device in these examples, the 
Directory can be listed on any device capable 
of accepting output; keyboard (KB:), DECtape 
(DT:) , etc. 



Example 2 . 



#LP:<DK: [2^jaf,*]/DI 



A listing is produced of all directories in user group 200, on 
RKll unit 0. 
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Example 3 . 

#LP:<DK:*.MAC[*,*]/DI 

A directory of all file names with extension .MAC. on RKll 
unit 0f is produced. 

Example 4. 

#_LP:<FORTRN.* [27,27]/BI 

A directory listing of all files named FORTRN (all extensions) 
in the 27,27 UIC area is produced. 

6.3.2 Deleting the Files (/DE) 

The System Manager can delete files belonging to specific users, 
or he can delete more than one user's files at a time, by specifying 
various values in the UIC field of the command string. This is shown 
in the following examples. 

Example 1. Deleting all files, with a specified extension. 

#_DKJ2f:*.FTN[*,*]/DE 

All files with extension .FTN, under all UIC's on the RKll 
unit are deleted. 

Example 2 . E)eleting a specific file 

|_DT 1 : PGM . MAC [ 2 j2f0 , 2 j2f ] /DE 

The file named PGM. MAC, belonging to user 200, project 200 
in the MFD of DECtape unit 1 is deleted. 

6.3.3 Transferring Files 

The general method of transferring files is described in the 
PIP manual. The System Manager has the added capability of trans- 
ferring files across UIC's as illustrated in the following examples. 
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Example 1 . 

#DK: [*,*]< DK1:*.LDA[*,*] 

All files with extension .LDA are transferred from RKll unit 1 
to RKll unit 0. Any UIC ' s on RKll unit 1 that are not already in 
RKll unit JZf's MFD are automatically entered. 

Example 2 . 

£DK1: [*,*]<DF:*.*[277,*] 

All files belonging to all users in project 277 are transferred 
from the RFll disk to RKll unit 1. UIC's within project 277 
that are not already in RKll unit I's MFD are entered automatically. 

Example 3. Transferring files to System Manager's area 

#_DK:< DKl:*. *[*,*] 

By omitting a UIC specification on the output side of the command 
string, the System Manager forces all files to be transferred from 
RKll unit 1 to RKll unit 0, in area [1,1]. 



6.3.4 Superseding Files 

The method of superseding files on a device is described in the 
PIP manual (DEC-11-UPUPA-A-D) . 

6.4 DEVICE INITIALIZATION 

Devices that can be initialized are DECtape , magnetic tape, and 
RKll disk. Initialization is accomplished by means of the Zero switch 
(/ZE) . Refer to the PIP manual for details. 



6-6 



APPENDICES 



A 



APPENDIX A 



SYSTEM GENERATION BATCH STREAMS 



A.l BUILDING A DISTRIBUTION KIT 

BATCH/DOS-11 system programs is accomplished by the following steps; 

1. Assemble the system programs, putting them on an 
RKll disk in object form; 

2. Use PIP to transfer the object programs from the 
RKll disk to the distribution medium. 

A. 1.1 Assembling System Programs 

The following BATCH-11 command sequence causes the system pro- 
grams to be assembled. Each $CH command refers to the assembly 
commands for a particular program: 

$Crt uKi lUitiH. ASM 
$CH UKUfcUiT.ASM 

*CH UM; Our, ASM 

$CH UKl;l'iL.DhP,A3M 



The individual batch streams that assemble each program are: 



ijXi\j\,/iara 



SHU MAURU 
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LIBR.ASM 



EDIT. ASM 



CREF.ASM 






SRU MAChO 






PIP. ASM 



$HiJ MACRO 

**OKl !Tf<NfFe^,CDR<OKl 

#DK J IZErO,CO!^<0*<1 :S 

'*DKl!UNLOC.C'->«<OKl : 
#OKj !FAsTf^T,CnR<DKl 
«I3KI JpRriTfcC,C(;'f<<OKl 
<*nKi;nI«tc.cLif?<D'<J ! 
#nKi:DeuET£.CO.^<OKl 
#UKl !PlPtX,nBJ<OKj J 
«DK1 :TRNiPtR,OBJ<DK 1 
i^OKl IGLSUBS,UBJ<DKl 
ttOKt JALLOC.'mj<n»<i I 

noK\ iReNAH£,.rjBj<ot<i 

«OKi:UNLOC,nBj<OKl J 

#L)Ki :fastmt,obj<oki 

»*DKl :pRoT£C,aBJ<DKl 
»DKi JDiREc.nBj<nKt : 
#0K1 JO£L£Te,UBJ<Di<l 
SRU i^lP 

?*0M !PXP,0i3j»PlPav^ 
#DKlSPlP0V3.aB i ,Tt» 

<*DKi:PiP,D3j<r'<i ipi 

#DKi!PlpOvii,ORJ<DKl 
i*DKlJPIPQVl,li(5J<0Kl 
»DKl st£mpi <nKi :.iULO 
H\)K\ :T£.MP2<nKi :uNtu 
**OKi tpipav2.aBJ<0Ki 

«OKt !PiP0V3.UB J<0K1 
#DK1 : TEMPI , TEMP2/DE 



SSYM 
SYHD 

!3YH 
JSYM 
SVMD 
SY^Q 
YMDt 

:SYM 

SYf*D 
JSYH 
SSYM 
SYHO 

:SYM 

OUAY 
SOLA 

:QLA 

OlAY 
QLAY 
LAY, 
J OLA 
OUAY 

:OtA 

SOLA 
OLAY 
lOLA 



DEF.S 
tP,PI 
U£F,T 
DEF.G 
EF.AL 
£F.eM 

D£F,f? 

fF,UM 
D£F,F 
UfeF.P 
eF.DI 
DEF,0 
,SYMO 
¥,SYM 
Y,SY^ 
,SYHi) 

#Syho 

5YH0E 
Y»SY4 

f SYI^^D. 
Y,SY'^ 

YpSYM 

Y,SYN! 



PIPEX 

PEX 

RNFER 

LSUBS 

LOC 

T£R 

D 

£NAME 

LOC 

ASTMT 

ROTEC 

REC 

ELETE 

eP, PIPEX 

DEFjTwnFEP 

OtF^GUSiibS 

EF, ALLOC 

EF^ENTEf^ 

F.ZERO 

DEF,RENAi*iE 

EF»UNLOC 

DEF,FASTMT 

DEF^PPOTEC 

EFfDIREC 

DEF, DELETE 



,0eJ,PlP0VU0BJ,plF0V2,0BJ/D£ 
Pl,Tt!^P2/DE 

pex.hbj^glsubs.obJ 
!trnfe^,obj,ente».obj 

}DIRtC,08J 

C.DBJ,Z£-Rn,OBJ,i)FLeTE.08J 

C,DBJ,RE^AMfe,OBJ,PK'OTEC,OBj 

!TEMPl,TEMP2 

IFASTMT.OBJ 
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MACRO. ASM 



»UM S^lACUVK<UKliM4gQVK 



ODT.ASM 



$RU MALRO 



PILDMP.ASM 



SHU MALRU 



CILUS.ASM 






macku 

MAlN.gt5j<UKl:taMUL6rNAlN 

CUMUtt:,Ut3J<DKl;CUHtrU9f COMUtC 

tui (t;u,gbJ<UKlsCghl,u8,£QIrc^- 
l.UAu,UDJ<PKl !i;ofii»Ub,L.yAD 

mUKOUT ,MBJ<aKlsCUMCjUd#HUKt}aT 

H^c>Uu] ,UbJ<UKi :Hisbuur 
Hi,ougT,gtjJ<QKi;HtbuyT 
ftpfc!uur,ui3j<UKi;WKboQT 

MT8UUT,gbvi<0Ki:(iitJuur 

JCiLgi>.UCSJ<0'^l5MAlN,Uaj,ClLlO,Q8J 

:ciLy!Ji,UtiJ<yKl:tyCQH,udJ 

SCAUUi>i,UdJ<yKi;tUjTCl,.QBJ 

JTtMKl,UOJ<DKl!|,OAD,UBj,HQKtiOr,aDJ,KP800T,QeJ*Hi<eQOT,06iJ 
JTtMP2,UoJ<D)M SHCbyoT,ydJ#KHbUUrtUBJrTCbOOT,OBJ,MTaOUTiOBJ 
:CiLySsJ,UBJ<OKl;TtMPl,UdJ, TtMP2,UBJ 
STtMKl,0OJ,TtrH2,U0J/0t 
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A. 1.2 Putting System Programs on Distribution Media 

Three different Batch streams are used by DEC to put system 
programs on the various distribution media: 

1. PTBLD.DIS - Paper tape distribution; 

2. DTBLD.DIS - DECtape distribution; and, 

3. MTBLD.DIS - Magnetic tape distribution. 

A. 1.2.1 Paper Tape Build Batch Stream 



IPU 0K1JPTP.16K 

*PPi<DKl|PIP,l6K/FB 

IME TYPE to KHEV PEADV TO CCNTI^UF AFTER I APE! I^T? EACH papFPTAPF 

JHE REMevF AKr5 LABEL PAPEP Tape PTP'.I^K', 

SWA 

JPU DK1«PIP!,1#'K 

*PPl<DKl|SPTP'.eK/FR 

SKE RFMnvF AM5 LA?EL FAPEP TAPE SPlP,8K 

SWA 

$pu dkuptp'.ipk 

appkdkiipip.isx/fb 

$me remtve and lapel fapep tape ptp.isk 

SWA 

SRU DKlfPIP'.lfiK 

*PP|<DKljFILD^'P'.OPJ/FP 

$ME PF^OVF AKn LAREl PAPEP TAPE F TUr^^'P ,0B.» 

SWA 

SRU DKliPTP'.lfiK 

*PPj<0KliPIP.'^8J/FB 

S^E RFMPVF AKPi LAPEL PAPER TAPE PTF'.CPJ 

SWA 

$RL DKlJPIp'.l'JK 

#PPl<DKlil INKOB'.OPJ/FP 

5ME REMOVE AKD LABEL PAPER TAPE UINKCP.HB.T 

SWA 

SRU DKliPTp'.lfK 

*Pp!<PKiiFDTT'.CPJ/FP 

$ME REMOVE AKP! I APEU PAPEP TAPE EClT.OBJ, 

SWA 

SRU DXllPTP'.l^K, 

*PP»<OKllODTl!R.ORJ/FP 

$ME REMOVE AND LAPEL PAPER TAPE Cr^TUR.rB!, 

SWA 

SRU DKIIPTP',16K 

*PPl<OKlfLIPR'.CPJ/FP 

SME REMOVE AKO LAPEL PAPER TAPE L!6P,CBJ 

SWA 

$RU DKltP!p'.16K 

*PPl<OKliCRFF.CPJ/FP 

i^E REMOVE ANO LAPEL PAPER TAPE CPEF.OBJ, 

SWA 

SRU 0K1IP!P'.16K 

*PP!<OKllHACRO.CBj/FB , , 

SKE REMOVE ANO lAPEL PAPEP TAPE mKPO.CBJ. 

SWA 
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i^L uKiiPiP,i6K 



*PP 

SRU 

*PP 
IME 
fWA 
fRC 
*PP 



i<nKi}MArRpp.Cipj/FP 

REMOVF AKH LA^EL PAPEf^ 

DKliPTP.l^K 
f«r!KliHAecVR,CBJ/FP 
RFMCVF AKD LAPEL PAPFR 

Dt^llPTP'.ieK 
f ^I^Kl jPST.f^RJ/FR 
REMOVE AKC LAf'EL PAPER 



SRU DKllPTPUfiK 

*Pp|<CKlfPSTP',CPJ/FP 

S^^E RE^nvF AKD lAPFL PAPER 

SI^A 

fRU DKUPTPUfiK 

*PPf<DKl|VArRr!SUPA/FP 

S^E REHPVF AND I APEL PAPER 

JWA 

JRU DKlspip'.ieK^ 

wPrMuKl iPIPCvg.uBJ/FP 

$ME REf^nVE AKfj LAPE! PAPER 

!WA 

SRL D»<lJP|p'.16K 

*PPt<DKl|PlPCVl'.CPJ/FB 

5ME REMOVE ASn LAPEL PAPER 

SWA 

SRI DKlf P!P'.l«?K 

*PPi<DK!|PIPGV2',cPJ/FP 

SMp REHPVF hh^f LAPEL PAPER 

Sli^A 

JRt DKllPTP'.l^K 

*PP|<0K1?PIPCV3,CPJ/FP 

jMf RfMflVF AKfJ LAPEL PAPFR 

JNA 

JRU DKltPTp'.16K 

*PP|<0K1|I IK'K'.PK/FB 

SME pFMnVF AKf* LAPEL PAPER 

SNA 

SRU DKltPTP'. IfK 

*PPl<DKl|| IKiKf5e',8!</FB 

JMf RFMOVF AND I APEI PAPER 

SWA 

5PL CKlfPTP'.lCK 

*PPf*DKl ILIK'K'.I'K/FP 

5ME REMOVE «NR LABFI PAPER 

SWA 

JRU DXllPTP'.iaK 

*PP|<DKlsl INKrp',12K/FP 

SME REMOVE AND I APEI PAPER 

SWA 

JRL' DKllPTP'. If-K 

*PPf<nKltLIK'K.CPJ/FP 

SME RFypvE AKD I APFi P^P^P 

SWA 

SRI DKlfPTp',16K 

*PPl<DKltri!. tS.CBJ/FB 

SME RFMOVF AKO L APEI PAPER 

SWA 

SRL DK1!PIp',16k 

*Pp!<r5K!:riLU$Z,0PJ/FP 

SME REMOVE AND I APEt PAPER 

SWA 



TAPE -•''ACRCP.OPJ 

Tare macovr.op.t 
tape pst.cpj 

TAPE PStP.OBJ 

TAPE MACROS, LCA 

TAPE PIFCVP'.OPT 
TAPE PTFOVI ,Oe.T 

TAPE P!Frv?,nB,f 
TAPE PTPrv3.oe,T 

TAPE LINK,PK 
TAPE LfN^CP.BK 
TAPE LTNK,!2K 
TAPE LIM<0P,l2>f 

Tape LlNK.Ofl.j 
Tape ctlls'.cpj 
Tape CTLLS«'.npj 
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fPL DKlJPIp'.lfK 

JHr RFHOVF AND lAPfcL PAPER TftPf CTLLS1,nP.T 

fWA 

fRU DKitPTp'.lSK 

*Pp!<DK!!riLLS2'.0PJ/FP 

IMF. RFHOVF AKD I, APEl PAPEP T^PF CTLISP.HPT 

SNA 

SRU DKlipip',16K 

*PPj<DKlfrilUS3.0PJ/FP 

fME RFK«OVF AND lAPEI PAPEP TAPE CT|,l S?,nP,T 

fWA 

5RU DKlipip'.lfiK 

*PPf<nK!jPST, MAC/FA 

5HF RFMPVF AKH I APEl PAPFP Tape P?t>AC 

SWA 

5RU DKHPIP.ISK 
*PPt<DKliSY5HAe'.SML/FA 

SHE RFMPVE ANO lAPEI PAPEP TAPE SVS^'AC.SVI 
SWA 

fRt DKlfPTPl.l6K 
*PPi<OK! »r,0AP16,0rS/FA 

S^'E RFHCVF AND LAPEI. PAPER TAPE GCAFi6,nOS 
fWA 

fRU DKliPTP^ieK 
*PP!*nKifr,OAP',i^K/FA 

JME REMOVF AKT LAPEL PAPER TAPE GfAP,i6K 
SWA 

JRl DKlJPTP'.16K 
*PP!<i5Klir-0AP, ALL/FA 

i^'B RF^*nvF AND I APEL PAPER TAPE GrAP.AIL 
SWA 

SPL DKlJPlP'.l^K 
^PPkOKIiPOTA', IfL 

i^E RF^TVE ANC I APFI PAPER TAPE GrTA,16L 
SWA 

ff'F ALL CF THE POP-U SVSTpw PprGPA^'S H4VF h Q^ PpFM 
SHE WRITTEN C^TC PAPER TAPES, 
SFI 
A. 1.2. 2 DECtape Build Batch Stream 
5JCF DTRLr^t!#n 
S^'E MfiU*^'T SCRATtN DFCTAPEP r<K 
SHE UMTS AK'C I'.SFT RF^^niF 
S^E AND WRITE EKAPLF PWTTrHFS C^ PCTH. 
SHE TVPE rC l»HFK READY TO CPNTIMlF, 
SWA 

SRL DKliPIp'.lfiK 
*DT(?s/ZF 

*^nTp j<DKltPlp', iet</FR,PIP,12K 

#0,T?i<D!<l!SPIP,PK/FP,F()TT',0PJ,CnT1 iR.flBJ,! TpR'.CP J fpTLP^ P ,(^p.! .TRFF; C 
*DTP»<DKlfMACRC,CPJ»MACR0P,npj,MArCVR,CPJ.P?5T.aPj.P.*»TP,rP..T/FR 

*DTPi<oKiiMAePcs,i DA#PiP,rB.t.PiPOve',cpj,PTP'^vi ,fpj,piPcv?'.rPj/FP 

*DTPs<DKl!PIFrv3.rB.J,l, I^k'.8K/FB 

#DT? j<pKl!LTKKCP,8K/FP,LT^^K,l?K,LTNKCP,12«,l T^K .rP J .LJNXCP .rPJ 

#LPi<RT<?|/D! 

*DT! i/ZF 

*DT1 KDKlfCTLls'.OPJtCTLi SP ,Ce J ,CIU? 1 .OP J 

*DTls<DKifCTLLS2.CBJ#riLUS3,CPJ 

*r5Tl |<DKl?PST',HAC/FA»PY5MAC,?^'L»GrTAie,nn<s 

*DTi !<Dt<lfGPTA,!6K/FA,GnTA,ALL,PCTA,16L#Gr'TAl6.rr 

*LPi<OT!t/DT 

S^'E RFKCVE rECTAPFS FRO^' UMTS (? AM? ! ANr^ i APE! THFM, 

H A V F »> r V P F F N' 



SWA 




SME 


AIL CF Tk-F PDP-11 SYSTE" PR'•GPA^'S 


SME 


WRITTFN C*^ nFrTAPFvS 


SFI 
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A. 1.2. 3 Magnetic Tape Build Batch Stream 



5JCP ^^TPLl^CIf!} 

5^*E MCU^T A yAR^FTIr TAPE 

IME YVPF I'Cr" kf"F^^ READV 



Ow LNTT..e,WPTTE EK^PtFp'. 



T» V» ( If 

#OTP 
*(5TP 

*QTP 

*(5T? 

*GTg 

*ST(? 

*QTP 

*STP 
*CT(? 

*{3TP 
*GTP 
*RTP 
*QTP 

*GTP 

*QTP 
*GT(? 



SWA 

SPL DKiiPTP),l6K 

*5T?IG0AM16.DPS<DI^1|G^A^^16,DC?/FA 

#(3T?I'",CA^^', lfK<DKriGCA*',16K/FA 

*RTP|GCAM^ALL<CK1 JGrAM,ALl /FA 

*QT!?ir,CTA.lPL<n«ltGCTA,16L/FA 

*RT!?iPIP,16K<n)Kl|PTP,16K/FB 

*GTP j<DKl IPTP,1?K/FP 

*GT(7t<Dt<l;SPIP,!'K/FP 

cClT«CPJ<C'^lftwIT,rSJ/Ff5 
ODTl!R.CRJ<Dt<MCrTn»,OPJ/FR 
! I!»R.OPJ<r''l!L!eR,rBvT/FP 
FIlD^P'.CPJ<Dt<lfFTLnMP,CPJ/FB 
fRFF'.OPJ<D^lsCPFP,rB..T/FP 
^ACRn,r8J<DK5 :HArRri,nBJ/Fe 

^'ACRPP^C«^J<D^'t!^^ACPnP,rH,T/FP 

"ACCVR,CPJ<DKlfN4CffvD,npj/pg 

PST.rBJ<DK1 iPST,rBvT/F8 
PSTP'.OPJ<DKlfP«!TP,rBJ/Fp 

WACRns'.Lf5A«DKliMACP0S,LDA/PB 

PIP.r!BJ<DKl?PIP,rRJ/FB 

PIPCV0,CPJ<RK'!iPTPrVP,CPJ/Fe 

PlPnvi^CPj<OK J ipTpnvi ,OPJ/Fe 

PIPCV2^,CPJ<Dt<l «PTPPV?,npJ/FB 
PIPCV3',CBJ<Di<l!PTPrV3,f^BJ/FB 
LINk'.8K<0K1 SLINK'.8K/FB 
LIK'KPB'.eKcnKi ;( IkKCB'.BK/FP 
LI^^k'. l?K<DK'l tLTKK,12K/FP 

lIM<rB'. !?K<DKiaTNK0P,12K/FB 
LIf^^K.OPj<DKltL!NK.rBJ/FP 

I. INKne.CPsJcDKl fLTNKOP.PPJ/FB 
CIL UP .JDEJxTK J stlLU*? , PBJyF.fi, 
1 1 ! . L ? ^ J. C P J < D K 1 J C T L '- ! S "" , B J / P R 

riLusi,rpj<DKi jCiLisi ,npj/FB 

CILL?2,CPJ<DKl!C!LLS?,np J/FB 
f"f\ ii«"?' rp ?*nw# trri tc^ no i/tn 

- i V •„ ■. W » W ■ W ~ ■.-■' ■ ■ J. • •-. J U '•-. W > ■ I ■ I., 1,,' ^ ■ !J 

PST,»«'Ar«rK!.PST,MAf-/FA 
SYSyAC',S^L<DI'l !SVS^'Ar,SMl /FA 

*LPi<MYP,/DT 

*>'T?|/Ri' 

f^r RF^rvF MAGKFTTCTAFE PPOM LMTp 

SWA 

JFT 



? AKD L.*PFL Tl-F MAGKFTir TAFF 



A- 7 



A. 2 GETTING ON THE AIR BATCH STREAMS 

Recall that the BATCH- 11 user builds the system programs on 
his system device by specifying the following commands: 

fPR: 1 
1. $RUN <DTn: > PIP.16K 

[MTn:J 

2a, Paper Tape 

#SY:G0AP16.D0S<PR:/FA/SU G0AP16.D0S tape in reader 

?SY:G0AP.16K<PR:/FA/SU G0AP.16K tape in reader 

#Sy:GOAP.ALL<PR:/FA/SU GOAP.ALL tape in reader 

FSY:G0TA.16L<PR:/FA/SU GOTA. 16L tape in reader 



2b. DECtape 



#_SY : <DT1 : G0TA16 . DOS/FA/SU 
#SY: <DT1 :GOTA. 16K/FA/SU 
fSY : <DT1 : GOTA. ALL/FA/SU 
£SY:<DT1:G0TA.16L/FA/SU 
Go to Step 3 



2c. Magnetic Tape 



|_SY : <MT0 : G0AM16 . DOS/FA/SU 
£SY : <MT0 : GOAM. 16K/FA/SU 
# S Y : <MT0 : GOAM . ALL/FA/SU 
£SY : <MT^ : GOTA. 16L/FA/SU 
Go to Step 3 

3. £+C 

fGOAPie.DOSl specify appropriate 
?BA JG0TA16.D0S> batch stream 
~ [GOAMie.DOsJ 

The batch streams transferred to the system disk, and subse- 
quently read, are listed in the following sections. 

A. 2. 1.1 G0AP16.D0S 

»aOAH,*,tiUTA.*/Qt 
<*OUTUH,lMP/KE<ODTllH,GbJ 

«aQT,OBj/f<t:<OpTllP»Trip 

$NA 

*>syjCl'<',5ys«pr:/ka 
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*Mt PO^lTiUN Cl5!,STS an RtAoen 

#SYSCl,5i.5Y5<PH!/FA 

SME PQiiniUN Cl.3tSr§ ifH ^tEAQtK 

SNA 

#syjCu>ifi>t3<PR;/KA 

Sfl£ POSUXQN CU4,SY5 iN HtAOtK 

«SYiCL4,SYS<PR!/FA 

iMt PQSliiUN CW5,SY5 IN KtAOEK 

SMA 

#SYJCi.!?,3YS<P«S/Fa 

$Me POSIUON Ct,6,SY5 iN HEAi^EK 

SWA 

)i»5Y?CL&.SYS<PH5/FA 

$Mfc POi»lUQN C1,7,SYS IN f^KAOtw 

SWA 

#SYjCu7,5YS<PRS/PA 

SHE rO^IfiUN uuLi'Mp • 1,1'* X''^ rscAutl 

SNA 

»SYiLDUHP.UDA<pKJ/f-|s 

SFlNiSrt 



A. 2. 1.2 G0AP.16K 



SME AFTfcK PcSlTlUNlNti tAC.N PAPtK TAPt IN TH£ HfEADEH 

SME TYPE LQ WHEN HtnOY Tu CwNTlNyE, 

SME POSmON PIP,10K IN PAPtK TAPt PtAUtK 

SWA 

SCitT PK? 

SSA PlP.ieK 

$mE position S^SMA^.SML iH PAPEH I APE KfeAUER. 

SWA 

spy Pip.iftK 
#sysmau,5iiu<p.r;/Fa/su 

SHE P05>I]iQN ^'iAC'<0•ObJ IN PAPEH TAPE REAUt.f*. 

SWA 

SPU PiP.lbK 

#HA(;Hu.otfJ<pP;/F!S/i>u 

SHE PoSiTiDK PSTfOojf IN PAt^ew U^t PEAOfcW. 

SWA 

SRU PiP.i&K 

#P3T,abj<PPj/FiJ/Su 

SME PQ^XTluN Lli'-'^O&.ikK In PmPE?* TAPt. HcAQEk, 

SWA 

spg PIP,lb^ 

<»UiNK0a,i2K<PR;/FB/Su 

i!^t POSiTiQn LiNi^.l^^ if^ PAftH TAPt ^'^t.AUEK 

SWA 

SRU PIP. UK 

«fUiNK,l2'^<PpJ/Fc/SU 

»M£ PQiililON LiN^OO.UoJ iiv( PAPEK TAPE HEAUEk 

SWA 

SRU PIP.I&K 

*»LI^^0t>,U!iJ<PRJ/Fti/5U 

SME POSi I iQN LiNi^.yb^ IN t^APEK | APE ^tADEft 

SmA 

spy PIP, UK 

«uIN^,UBJ<PPl/FB/SU 
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A. 2. 1.3 GOAP.ALL 

$M£ AFltK PoblTlUNANti tACH PAPtK I'APt iH 1 HI Rt^,Ot^■ 

Sfit rypfe cw ■'^hen r^auy to conunue;, 

$Mfc PoaiTlUN tUlT.UtJJ In PAPfcH lAPt HEADtH 
$WA 

$«y PiP,i&<s 
<»£aiT,uej<PRj/i^b/sy 

Sfi£ PO^HiUN OOTU'^',*JBJ IN PAPtrt lApR RtAUEP. 

$WA 

SKU PIP.IO^ 

*»OOTU'^,UDg<Pw:/Fa/sy 

SMfc PO^lTiON L.iB'^tiJbJ IN P.APfeK lAPE KfcAUtK, 

$WA 

$HU PIP.lbK 

#l,lBht,UBJ<PPS/Fe/Sw 

$H£ PgisinON !^lUU!^H,UdJ- IN PAPtK TAPt Rt;AO£t^. 

SWA 

$RU PlP.lfciV 

#FlLaHP.UBJ<Pf<i/Pt;/SU 

$M£ POSlUaN C'^feP.ybJ IN PAPEH jAPt Hfe^AptH, 

SHU PIP,16!< 

#Ch!fc^,UdJ<PPJ/FB/SU 

$1£ POSlIlON PI^'.CDJ 1*^ PAPtK lAPfc PtAUt.K 

ShiA 

SRU PIP,l&^ 

*»PlP,Ot5J<PKS/Ft3/SU 

$M£ PQOlUON PlPUVi^.UbJ i^J pAPtK TAPC Rt**u£^<, 

$NA 

$Rg PIP.lbK 

»»PlPQVKj,y»J<PRS/PH/5U 

$Mt POSITION PlpOVl.UbJ IN PAPt-H JAPt PfcAu£W, 

$WA 

»KU PIP,i&^ 

#PlPUVl,U»J<PH:/Ffi/SU 

*Me PO^ITIDN PiPOV«i.UbJ In PaPcK TAPc RfcAUhH-, 

$HA 

$RU PiP.lfeK, 

#PIPUVI^,UCJJ<PP!/FH/5U 

SHE PQ5>IliON PiPUVo.UfcJ In PAPfcK iApt KtAQtH. 

$i^A 

$RU PlP,lbK 

#PIPUVs3,yt>j<PK;/pB/su 

$M£ PO^iTlQN CllUS.UOJ l!N PAPtH TAPt RtAUt^, 
Si««A 

ajRu PiP,i&< 

<*CXt.US,0!3g<PK!/Fls/iu 

$ME PQiJlTiUN ClLU5*2.Ufc!j IN PAPt^< TAPC RtAUth, 

SwA 

$RU PIP. 16^ 

#ClLU5W.,UtJj<PP!/FB/SU 

SME PQSlIjijN ClUUSl.Oaj In PAPt»< lAPt RtAUEH, 

$»iA 

SkU PIP.l&K 

»CiLU§l.UcjJ<PKl/PtJ/i>W 

$Me PoiilTiUN CALUSii.UtiJ Isi PAPtK 1 APt kfcAueK, 

$MA 

$HU PIP,!©*^ 

i»ClLUSii,UtJJ<PNS/Pb/SU 

SMt PO-JUlilN ClLUS^.Oba IW PAPtK I APt RtAOEP, 

iviA 

$KU PIP,16K 

i»ClLUS»5,UBj<PRI/FB/i>U 
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A. 2. 1.4 G0TA.16L 



NOTE 



G0TA.16L is the same for all media. 



«MACKg<MAtWUfPST/fc 

#CR6F<C;Ht^/E 

»P 1 P V Ki < r i f"" V fej , u o J / ti ti / E- 

i*piPQvi<PiPon.aaj/t 

#PiPuvii<*'iPo¥2,o6j/c;c:/t 

#piP0y4<PiPuv>j,Qtdj/t 



A. 2.2 DECtape Batch Streams 
A. 2. 2.1 G0TA16.D0S 



$JOS GUTA16C1,U 

$Mt Moufsif i)f.:g.ii,ot5PA-A-uC2 UN uiii »"Rire LOc^tD 

S^E TYPfc "CD" WHtK- PtApt 

$CH UuTAtlOK 

$CH tiUlAiALL 

$CH CiuTA,l&L 

$PU PIP 

<*GOTA,*/Pt 

#QtJTll><,TMP/K£<OQTlit<,ObJ 

*»*fQBJ/Dt 

#OQT.OtiJ/Kt<uDrilR.rf^.P 

»*.«*<? •,lii^/wt 

ibMt ^UUnT Utt^l l-oep^UA-A-'Jl. ON uT<4S '^'RITt ^uCi^ 

SWA 

l*SYl<ur^S*,SY3/FA 

«»SY:<DT^:LUUMP.uaA 

SFUasH 
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A. 2. 2. 2 G0TA.16K 



<*SY8<UT63JnACHa.DdJ/ptJ/i>U 
*r5yj<QT0SPST.DiiJ/f tt/5U 

#SYl<Qr0;i.lNKO5i,aBwl/F»/SU 



A. 2. 2. 3 GOTA.ALL 



$«U DTI^IPIP.ISK 

#SYl<OT0iODTin,OBJ/i-o/Su 
»5YS<DT0ll,lB*<.QbJ/fti/vSU 
«SYJ«DT0lf iUPMP.OBJ/l-b/JiU 

#sYMDr0sg«fci'-,Q8J/i'e/su 

#SYl<DT0SPiP,ObJ/Fe/au 

#&Yi<QTaJPlpuva,UBJ/f »/su 

«*5Yl<DT2jIPiPOVi,0BJ/^b/SU 

#sYi<DriaJPiFyv2,0BJ/^p/i5y 

ttSYKQTalPlPUyi.Qeg/Pb/SU 

#SYs<0TiigXLU5.0BJ/f^l3/J3U 

<»SYl<prilCiUUS«3,0B»'/'*»/fi>vi 

#SY!<DTi JClLUSl.UBJ/^e/^U 

#SYl<0TnciUU52,U6J/f'O/5iJ 

»SYl<DTlSClLUS3,UtS<J/^t>/5J 



A. 2. 2. 4 G0TA.16L 



#MACHO<^At;KD^PST/e 
*EOlT<feOil/t 

»FIuPMP<f-XLDHp/T?3/4&fc?/fc 
#C«tF<CRtl»/fc 
#PlP<plP,QeJ/Cw/0v;4/t 
»PlPOV*!)<PiPOVfe;,0t^J/CC/t: 

i»PiPQvi<PiPovi,oyj/fe 

#PIpovi6:<PiPov2.otij/ct/t 

«PIPQv4<PiPgVvi,0tJJ/fc 

#cit,usa,ovw<ciLusg.ubj/t 
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A. 2. 3 Magnetic Tape Batch Streams 
A. 2. 3.1 G0AM16.D0S 



j^Cn ijiUMMelOis 

$CM b0TA,16L 
SKU PIP 

»50AM,*,iiQT««.*/0t 
SaDTUK, !MP/H|:<0U"TUH,USJ 

IfUDT.DMJ/Kii^QpTllR.TMK 
#*.8iS,*,liSK,*, |KP/Wt 



A. 2. 3.2 G0AM.16K 



*RU MT«3;PlP,loi<, 

?*PST»UbJ<MT«tPST,Q£JJ/|-H/sj 

*» L I N N , i 2 !^ < ^5 T -=3 S U I ^''i ^ . 1 «i ^ / »"■ !5 / i? ' J 



A.2.3.3 GOAM.ALL 



»«U MT^lPiP.ib^ 

»Oi)TllK,UciJ<HT4jOOi llK.ODj/Fa/bU 

*»F i UUmP , Ub J <f^ T .3 : P I UUf^t^ . t'tj J / P b / i)U 

»CHtP,UtjJ<MT<^JC*^tF»UDJ/'>b/^U 

»PlP,DtJJ<r>Tk'.;FIP,0OvJ/Pb/Su 

«»PiPUva,utsa<''*(T^i8Plru¥ii,gr}J/F»/&u 

*>PiP(JVl,Ot*J<PiT<ilPlPuVuubJ/Fe/Su 

»PlP0Viii,yDJ<f*T^tPlPpV^,UoJ/F!3/5u 

*tPIPOVO,ybJ<MTi5jPlPDV^,U&J/Ft3/3U 

»ClLUSki,U£jJ<^'T^sCIUUii;,U3j/Fb/SU 

»Cii.U5i, JoJ<'iT^igiwu5i,uifj/Fb/&y 

»CiLUSO,QDj<'"iT^Jt.itu&>5,Ub.j/Fb/5U 
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A. 2. 3.4 G0TA.16L 



#eDiT<feoiT/t 

<*FI|,UrtP<PiLDPiP/T; J/4t;»^/t 

#pip<pxp.ut>j/c;u/uv Jit/fc. 

#PlPUV^}<PiPDVv!i,Ut5j/tC/t 

#piPuvi<PiPovi,Daj/c 
ttpxpuvi<i<i^ipoygt0bj/'cu/t 

»PlPQV»i<PiPyVd.U»J7t 
i*CiUiJ5o,yvR<wXUU«5B.uD»i/t 
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A. 3 BUILDING SYSTEM PROGRAMS 

The process of completely assembling and linking 
system programs is accomplished by the batch stream CUSP.BLD, 
shown below. Note that the assembly procedures have been discussed 
in section A. 1.1. Sections A. 3.1 and A. 3. 2 describe the batch 
streams that link and test the system, programs. It should also 



1 J- ^ J 



-T T J -U 






,_ J_1 J_ J_1 I- 



Stream device is an RKll disk, mounted on unit 1. This specifica- 
tion should be modified by the user, if necessary, to accommodate 
his choice of batch stream device. 



*ja8 CaPOLU [I , I] 


*CH 


UKiSUl^KiA3M 


*Cri 


UKi;ipibH.AiM 


*Cfi 


Ui^ i sc-uii , ftaf*i 


*CH 


UM'.LKtF.AbM 


iCri 


IJ^iZ^'lP.aSn 


iCH 


ui<i:f''AgHU,ASi^ 


Sgii 


wKi ;yu! ,Ajj''l 


>C" 


U«.iSriL0MP,A3K 


sen 


tMi:i-ii.u5,MSM 


*Crt 


UKi Ji'lAUwU.wNi^ 


*Cfi 


UKi ; wioRfU'MK: 


iCn 


UM Sfcuil •U'NK 


*C(1 


w!Vi Jt^K&f- .L'NK 


$Cn 


WKl Jf^lH.UNK 


sen 


Ml^^:uiN^,L^^K 


sen 


iJKi;r xur.jntJ,i.iNK 


*Cn 


uiM :viuu-S,i.N'^ 


iCn 


U K i ! W i b T , IJ i H 



To link system programs, specify the following $JOB statement 
to BATCH: 

$JOB CSPLNK[1,1] 
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This causes the following batch stream to be read: 



«JQa CSPLNi^tljU 



$CH 


UKl 


{MttCkU.UNK 


sen 


Uftl 


fUiO^.tWK 


*CH 


wKi 


jtOiUL'NK 


sen 


UKl 


SCKtl-ANK 


SCfi 


UKl 


iPiP.LN^ 


$Cri 


ukU 


uX'NK.tNK 


SCI 


UMJ 


Ui-onp,uNK 


*Cfi 


UKli 


WXUui.UNK 


»C1 


wMJ 


i-A^TtUiH 



A. 3. 1.1 MACRO. LNK 



$NU LINK 

#Di< i: MACRO, tPKDKi; MACRO rPST/E 

#0K 1 1 MACHUP, i,P ? <DK IjHACROP.i ACQ VR, PS Tp/T J 37 46ci/e 

«0KilMAcR0Q,LP:<0KnHACRD,MAC0VR,PST/T!5746^./E 



A. 3. 1.2 LIBR.LNK 






A. 3.1. 3 EDIT. LNK 



SHU LINK 
»OKi;tUXT,LPj<OMjtDiT/t 



A. 3. 1.4 CREF.LNK 
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A. 3. 1,5 PIP.LNK 




A. 3.1.6 LINK.LNK 



$Wy LINK 

«aKlSLiN^,UK^<QKUUINt^/E 

»UIM JHN'^Ub,LPI<UHUl-iNKud/e 

itUM S U A NfV . i a^ , WP ! <UK 1 S U INK/ T ! 55' 4bM/£: 



A. 3.1. 7 FILDMP.LNK 



$RU LINK 

»OKi JfitOMP,LP:<OKUKiUD^«P/TU/4ba/fc 



A. 3. 1.8 CILUS.LNK 



*»QKi Jc:iLuj>#L>'s<D'<i Jciuus,ati.j/c;c/ov;4/t 

**UM!CXLUSi.UvK,UP?<IJ'^lSClUUSi.ObJ/E 
#UKi?C;lLUS2.UVf*,LP»<u)MSClUU52,UDJ/e 
*»0M JCitUi?^.'JVi<,uP«<l.)MSCiUu53.CiDJ/Ct;/E; 
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AFFiliNDlX a 



SYSTEM CORE REQUIREMENTS 



B.l MONITOR CORE SIZE ALGORITHM 

The amount of core occupied by a BATCH-11 or DOS-ll Monitor at 
a given time is determined by the needs of the system at that time. 
Thus, this amount fluctuates depending on the circumstances of the 
moment. To determine the core requirements of the system, add the 
core sizes of the following items {all values are given in decimal) : 

1. Resident Monitor (refer to section B.2); 

2. One driver for each device that has been INITed, but 
not RLSEd. (NOTE: Do not include the driver for the 
system device. This is part of the Resident Monitor's 
requirements) ; 

3. One buffer for each open dataset (refer to section 
B.2.4); 

4. One dataset data block (DDB) for each open 
dataset - 16 words; 

5. One file information block (FIB) for each open file 

(a file is a dataset on a file-structured device) - 16 words; 

6. One bit map for each unit on which a file is open 
for output (6 4 words) ; 

7. One auxiliary buffer, during operations like OPEN, 
RUN, etc. (refer to Appendix C of the DOS Reference 
Manual) - 256 words. 

The size actually required by the Monitor is likely to be 
greater than that derived by sim.ply following the algorithm. The 
reason is that memory allocated in the middle of the Monitor, for 
fib's, DDB's, etc. is not freed when the associated dataset is 
released; thus, this space is not available for the DDB or buffer 
of a dataset subsequently INIT'ed. To conserve space for user pro- 
grams, it is recommended that datasets that will be released first, 
be INIT'ed last. (Buffer space is allocated at the top of the 
Monitor, as datasets are INIT'ed; this space is accessible when 
the dataset is CLOSE' d.) 

Typically, a standard DOS-ll Monitor requires from about 2142 
to 2213 words permanently resident, depending on the system disk used 
(see B.2.1). A BATCH-11 Monitor requires approximately 500 words 
more. Minimum sizes of the Resident Monitors are: 
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DOS-11 BATCH- 11 

RCll = 2142 2642 

RFll = 2145 2645 

RKll = 2206 2706 

A "typical" installation (e.g., DECtape, keyboard, line printer) 
will require approximately 1300 more words, in addition to the Monitor, 
for device drivers and buffers. 

B.2 MODULE SIZES 

The following sections define the number of words occupied by 
the Resident Monitor, the Temporary Monitor, transient modules, and 
device drivers . 

B.2.1 Resident Monitor 

The number of words needed for the Resident Monitor depends 
on the system device, and the number of user-defined resident EMT's, 
and non-standard devices (VAR) . 



System Device Monitor Size (Decimal) 

RKll = 1710 + VAR 

RFll = 1649 + VAR 

RCll = 1646 + VAR 

VAR = (NPHYDEV + UDDEV) * 4 + UDEMT + SRESEMT 



where: 

NPHYDEV = total number of standard devices defined for, 
and attached to, the system; 

UDDEV = total number of user-defined devices; 

UDEMT = highest EMT value defined by the user (in decimal) , 
minus 6 3 (decimal) ; when none are defined, UDEMT=0; 

SRESEMT = sum of the sizes of all EMT's made permanently 
resident. 

For a standard configuration, VAR is less than or equal to 44, 

The modules comprising the Resident Monitor, and their respec- 
tive sizes, are: 
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Module 



Size ( DeCilTictl ) 



RMNl 

RMN2 

RMN3 

RWN 

RMN5 

CLOCK 

DK 
DF 
DC 



412 
204 
257 
552 
135 + VAR 

13 



137 1 

Z5 r 



Only one may be resident^ 
depending on which disk 
is "cns sysuSiTi Qevice« 



B.2.2 Temporary Monitor 

TMON (for BATCH- 11) = 38jZf4 
TMON (for DOS- 11) =2816 



B.2.3 Transient Modules 



Module 


Size (Decimal' 


ALO 


251 


DLN 


256 


FCR 


238 


FCL 


256 


DCN 


254 


DEL 


256 


LUK 


232 


CBA 


256 


LBA 


170 


DIR 


215 


FOP 


250 


CKX 


203 


GMA 


143 


APP 


252 


AP2 


168 


REN 


212 


PRO 


158 


MTO 


254 


CSX 


255 


REC 


251 


INR 


428 


RLS 


183 


TRA 


177 


BLO 


143 


KIT 


100 


SPC 


46 


STT 


30 


OPN 


313 


CLS 


227 


GUT 


118 


CSM 


256 


CVT 


204 


LDR 


622 


LD2 


193 


SPO 


46 


DMP 


124 


RUN 


255 


CDT 


235 


BSF 


147 
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B.2.4 Device Drivers 



Driver 


Size 


DK (low density) 


128 


(high density) 


138 


DF 


77 


DC 


74 


MT 


455 


QT 


4 83 


KB 


600 


LP 


152 


DT 


190 


CR (ASCII only) 


251 


PR 


67 


PP 


78 



Buffer Size 

256 
256 

64 

64 
256 
256 

32 

48 
256 

48 

32 

32 



B.3 STACK SIZE 

The most stack space required by the BATCH- 11 or DOS-11 Monitor 
occurs during OPEN processing; 56 words are needed at this time. In 
addition, 10 words of stack space must be allowed for each possible 
interrupt (a maximum of 4). Thus, 100 words of core should be re- 
served, to provide an ample safety margin. 
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APPENDIX C 
MONITOR EMT MODULES 



MODULE 


NUMBER 


GLOBAL NAME 


(RES) 









WAIT 


I ( 


RES) 


N/A 


WRITE 


2 CRwN) 


Ri*iN 


(RES) 


3 ( N Y ii ) 


N / .4 


READ 


4 (RWN) 


RWN 


(RES) 


§ 




N/A 


INIT 


6 




INR 


RELFASE 


7 




RLS 


T??AN 


l^^ 




TRA 


BLOCK 


11 




BLO 


SPECIAL FCTNS 


12 




SPC 


STATU3 


13 




STT 


DIRECTORY SRCH 


14 




DIH 


ALLOCATE 


IS 




ALO 


OPEN 


16 




OPN 


CLDSt 


17 




CLS 


RENAHE 


20 




REN 


DELETE 


21 




DEL 


APPEND 


2? 




APR 


(RES) 


23 






PROTECT 


24 




PRO 


HECCkO I/a 


25 




REC 


SPARES 


26, 


27 




KSB OVtRLAY 


i0 


(REsS) 


N/A 


K9L 


31 




N/A 


EDP 


32 




N/A 


K8I 


33 




N/A 


fiNf' 


3^ 




N/A 


ecL 


35 




N/A 


SPARES 


36, 


37 




MSB OVERLAY 


40 


CRES) 


N/A 


GENERAL UTILHIES 


41 




GUT 


CONVERSION 


42 




CVT 


FILE OPE'^ 


43 




FOP 


FILE CREATE 


44 




FCR 


FILE CLOSE 


45 




FCL 


FILE LOOKUP 


46 




LUK 


BLOCK ALLOCATE 


47 




L8A 


GET BIT HAP 


50 




GMA 


CONTIGUOUS AULOCATOR 


bl 




CBA 


CHtCK ACCESS 


52 




CKX 


DELETE LINKED 


b3 




DLN 


DELETE CONTIGUOUS 


54 




DCN 


APPEND 2 


b'^ 




AP2 


CO^MAND SYNTAX 


56 




CSX 


COMMAND SEMANTICS 


57 




CSH 


EXIT 


6^^ 




XIT 


PROGRAM LOADtR 


61 




LDR 


LOADER 2 


6? 




LD2 


MAG. TAPE OPE'^ 


53 




MTO 


BINARY DUMP 


64 




DMP 


RUN 


65 




RUN 


ASCII DATE/TIME 


66 




CDT 


BATCh STREAM FLUSH 


b7 




BSF 
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APPENDIX D 



SYSTEM DISTRIBUTION KITS 



D.l PAPER TAPE KIT 



'apSj 



j.on-(c; 1J.J.O L.4. j.j,>iAUX<-/ii XvJL i_ i^iw>J.l Cctxiiis CliC 



following paper tapes (not including FORTRAN tapes.) 



BATCH/DOS VJ2f8 KIT - FOR PAPERTAPE 



CONTENTS 


TAPE 






SYSLOD.LDA 


DEC-11-OSLDA-A-PL 






DOS: 








MONLIB . LCL 


DEC-11-ODMLA-A-POl 


to 


P05 


RMON , LDA 


DEC-11-ODRMA-A-PL 






TAIL.LDA 


DEC-11-ODTLA-A-PLl 


to 


PL5 


RMON. STB 


DEC-11-ODSTA-A-PL 






CONFIG. MAC 


DEC-11-ODCOA-A-PA 






CFMAC.MAC 


DEC-11-ODCFA-A-PA 






SYSTEM. MAC 


DEC-11-ODSYA-A-PA 






BATCH: 








MONLIB . LCL 


DEC-ll-OBMLA-A-POl 


to 


P05 


RMON . LDA 


DEC-11-OBRMA-A-PL 






TAIL.LDA 


DEC-11-OBTLA-A-PLl 


to 


PL5 


RMON. STB 


DEC-ll-OBSTA-A-PL 






CONFIG. MAC 


DEC-11-OBCOA-A-PA 






CFMAC.MAC 


DEC-11-OBCFA-A-^PA 






SYSTEM. MAC 


DEC-11-OBSYA-A-PA 






CLj2f.SYS thru CL7 . SYS 


DEC-11-OBCLA-A-PAl 


thru PAS 


LDUMP . LDA 


DEC-11-OBLDA-A-PL 






CMDS.MAC 


DEC-11-OBCMA-A-PA 






^MON . OBJ 


DEC-11-OBTMA-A-PR 






-CL.OBJ 


DEC-11-OBCCA-A-PR 






BATMAN . OBJ 


DEC-11-OBBMA-A-PR 






LKP . OBJ 


DEC-1 1-OBLKA-A-PR 
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CONTENTS 



LABEL 



SYSTEM PROGRAMS 

EDIT 

ODTllR 

LIBR 

FILDMP 

CREF 

MACRO : 

MACRO . OBJ 

MACRO. OBJ 

MACROVR.OBJ 

PST.OBJ 

PSTP.OBJ 

PST.MAC 

SYSMAC . SML 

MACROS . LDA 

CILUS: 



CILUS.OBJ 

CILUS0.OBJ 

CILUSl.OBJ 

CILUS2.0BJ 

CILUS3.0BJ 

LINK : 

LINK.12K 

LINK0B.12K 

LINK. 8K 

LINKOB. 8K 

LINK. OBJ 

LINKOB. OBJ 

PIP: 

PIP.16K 

PIP.12K 

SPIP.8K 

PIP. OBJ 

PIPOVjZf.OBJ 

PIPOVl.OBJ 

PIP0V2.0BJ 

PIP0V3.0BJ 



DEC-11-UEDTA-A-PR 
DEC-11-UODTA-A-PR 
DEC-11-ULIBA-A-PR 
DEC-11-UFDPA-A-PR 
DEC-11-LCREA-A-PR 

DEC-11-LMCOA-A-PR 
DEC-11-LMOPA-A-PR 
DEC-11-LMOVA-A-PR 
DEC-11-LMSTA-A-PR 
DEC-11-LMTPA-A-PR 
DEC-11-LMPSA-A-PA 
DEC-11-LMSYA-A-PA 
DEC-11-LMOSA-A-PL 

DEC-11-UCILA-A-PRl 
DEC-11-UCILA-A-PR2 
DEC-11-UCILA-A-PR3 
DEC-11-UCILA-A-PR4 
DEC-11-UCILA-A-PR5 

DEC-11-UL12A-A-PL1 
DEC-11-UL12A-A-PL2 
DEC-11-UL8KA-A-PL1 
DEC-11-UL8KA-A-PL2 
DEC-11-ULNKA-A-PRl 
DEC-11-ULNKA-A-PR2 



DEC- 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 



•11-UP16A-A- 
•11-UP12A-A- 
•11-UP8KA-A- 
-11-UPIPA-A- 
■11-UPIPA-A- 
-11-UPIPA-A- 
•11-UPIPA-A- 
■11-UPIPA-A- 



PL 

■PL 

PL 

PRl 

PR2 

■PR3 

PR4 

•PR5 
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DEVICE DRIVER SOURCES; 



CONTENTS 
DC. MAC 
DF.MAC 
DK.MAC 
CR.MAC 
MT.iMAC 
KB. MAC 
PR. MAC 
PP. MAC 
LP. MAC 
DT.MAC 



DEC' 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 
DEC- 



LABEL 
-11-ODDCA- 
-11-ODDFA- 
-11-ODDKA- 
-11-ODCRA- 
-11-ODMTA- 
■11-ODKBA- 
■11-ODPRA- 
■11-ODPPA- 
■11-ODLPA- 
■11-ODDTA- 



•A-PA 
-A-PA 
-A-PA 
•A-PA 
•A-PA 
•A-PA 
•A-PA 
•A-PA 
■A-PA 
■A-PA 



D.2 DECTAPE KIT 



Six DECtapes are distributed, viz.: 



CONTENTS 

DOS V0B MONITOR TAPE: or, 
BATCH Vi2f8 MONITOR TAPE 

BATCH/DOS Vj2f8 SYSTEM 
PROGRAM TAPE: 

FORTRAN COMPILER V4A TAPE: 

FORTRAN OTS V2j2(A TAPE: 

BATCH/DOS Vj2f8 DEVICE 
DRIVER TAPE: 



LABEL 

DEC-11-ODMOA-A-UC Or , 
DEC-11-OBMOA-A-UC 

DEC-llOCSPA-A- UCl 
thru UC2 

DEC-11-LFCTA-A-UC 

DEC-11-LFOLA-A-UC 

DEC-11-ODRVA-A-UA 



D.3 MAGNETIC TAPE KIT 

A single magnetic tape (7- or 9-channel) contains either the 
DOS-11 or BATCH-11 system. The Monitor files are stored under 
account 200,200. 



CONTENTS 

DOS V08/FORTRAN V4A/0TS v20A/ 
SYSTEM PROGRAMS MAGTAPE 



LABEL 
DEC-1 1-ODFSA-A-MC 



BATCH V08/FORTRAN V4A/0TS V20A/ DEC-11-OBFSA-A-MC 
SYSTEM PROGRAMS MAGTAPE 

D.4 PAPER TAPE BATCH STREAMS 



G0AP16.D0S 
GOAP . ALL 
G0AP.16K 
GOTA. 16 L 



DEC-11-GOAPA-A-PAl 
DEC-11-G0APA-A-PA2 
DEC- 11-G0APA-A-PA3 
DEC-11-GOTAA-A-PA 
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APPENDIX E 
STANDARD CONFIGURATION MODULE 



E.l DESCRIPTION 

The Configuration Module source file is named SYSTEM. MAC. It 

ration. It also contains comments that summarize how to modify it 
to fit a particular user's installation. 



•TO SPECIFV A DOS-n CQMFIGURATIO^J, THIS 

jFIlt His TO BE EDITfO, ACCORDlNCi TO THE 

?INST?^UCTIOMS GIVEN IN THE FOLLOWING 

yCOMMFrnS, 

? 

slNSTPUCTIO-VS PRECEDE EACH OF THE LINES TO BE EDITED, 

THIS HODULF HAS SIX SECTIO^iS: 

1. SPECIFICATION OF A DEFAULT UIC FOR BATCH 

2. SHtCIFICATION OF CLOCKS 

3. SELECTIO^J OF DOS STAMDARD DEVICES 
a, SYSTEM lOENTIFTCATION 

S, SPECIFICATION OF USER DEFINED EHT'S 
y 6, SPECTFICATIOK OF USER DEVICES 

jTHE USER SHOULD BE AWARF. THAT THE CONFIGURATION MODULE 
jSk^ECIFIES a maximal set of DEVICES. "^HEM DOS IS BOOTED, 
jTHE INITIALIZE!' TRIES TO REFERENCE ALL DEVICES SPECIFIED 

J IN THE CONFIGURATION HOl)ULE AND CONFIGURES THE SYSTEM 

jTO THOSE A'HICH RESPD*-!D,THI15 A^^Y DEVICE WHICH IS EITHER NOT PRESENT OR '^OT 

•IM THE CONFIGURATION MODULE WILL NOT BE USED BY DOS, 

•REASONS TO QMIT A DEVICE FROM A 

jCONFIGURATIDN CAM BE TO RESERVE IT FOR OTHER PURRQSES OR 

jBECAUSE ir IS FAULTY, 



E-1 



?BATCH 



IAS 



?« 



JT 

jC 
FT 
?T 
•A 
tT 



CHA 
EPLAC 



HF.wE 

1 KWl 

2 KWl 
HE P9 
DEL 
ONFIG 
CLL=1 
DEL 
LL =0 
HE ^iE 



FTCLP=1 



USES A DEFAULT UIC «HEN NO UIC 
FCIFIPDr THE DEFAULT UIC IS tl,2]. 
NGF THF DEFAULT UIC [1,21 TO (X,Y3, 
E OPg If 2 inITH 

OFU X»Y 

DFU 1,2 
ARE ? POSSIBLE CLOCKS! 
1-L THE LI'^E CLOCK 
1-0 THE PR0GPAHMA3LE CLOCK 
OGRAMMABLE CLOCK WILL BE RUN IN LINE 
ETE THF LINE CLOCK FROM ALL POSSIBLE 
URATI0N3, DELETE THF NEXT LINE 

ETE THE PROGRAMMABLE CLOCK FRQM 
SSIBLE CONFIGURATIONS, DELETE 
XT LINE, 

•PROGRAMMABLE CLOCK 



MODE, 



fIN THE NEXT LINES ALL STAisjDARD POP-ll 

jDEVKES ARF defined, THIS IS DONE BY MEANS 

J OF OFFINING A SYMBOL FTXX, WHERE XX 

»IS THt DFv/TCE MNEMONIC, 

;T0 DELFTE DEVICE XV DELETE 

jFTXY=l BELDH, DO THIS FOR 

•DEVICES NOT WANTED IN YOU» 

FTDC=1 ;RC DISK 

FTKB=1 jTELETYPE 

FTPR=1 jHIGH SPfJ.D PAPER TARE READER 

FTDT=1 jOtCTAPE 

FTCR=1 jCARD READER 

FTMTsl ^MAGNETIC TAPE 



THE LINE 
ALL 

CONFIGURATION. 



FTDFsl yRF DISK 

FTDKsl jRK DISK 

FTLP=1 ?LINE- PRINTER 

FTPPsl jHIGH SPEED PAPER TAPE PUNCH 

PAGE 
ylHE SYSTEM GENERATED CAN BE IDENTIFIED 
•BY A USES DEFINED IDENTIFICATION LINE PRINTED 
jKHEN THE SYSTEM IS INITIALIZED, 
jINSERT THE IDENTIFICATION LINE BHT^EEN 
?THE ANGLE BRACKETS (NOTE: INCLUDE 
jNO ANGLE HR4CKETS IN YOUR TEXT) 
: ON THE NEXT LINE, 

lOENT <> 



jI.E, IDENT <RF SYSTEM NO RK> 
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;IN THE NFXT LIMES THE IDENTIFICATION PRINTED AFTER THE V 
;IN THE MONTTOR MESSAGE IS OEFlNhO, DO NOT CHANGE THIS, 
MONV**S <08-0?> 



.PAGE 
IF NO USE^ OEFINEH FMT'S OP NON 
STANDARD DEVICES ARE TO BE ADDED TO THE 
SYSTEM, THEN THE EDITIMQ OF THIS FILE 
T s F T N T S H E !) . 

IM THE nJEXt'sECTION NON-STANDARD EMT'S 
ARE DEFINED, THESE HAVE TO FALL IN THE RANGE 
140-177, ALL OTHER VALUES ARE RESERVED 
FOR DEC. 



IN THE NEXT LINE THE SYMBOL UDEHT 

MUST BE EQUATED TQ THE DIFFERENCE 

BETWFEN THE HIGHEST EMT VALUE DEFINED AND 

77 (ALL NU'-'BERS ARE OCTAL), 

A ZERO MEANS THERE ARE ^)^ NON STANDARD 

EMT'S, 

E.G. IF THF HIGHEST EHT IS 166 THEN UDEMT=67, 



iJDEMTs^ 
J 

jTWO DIFFERENT TYPES OF E^T'S CAN 8E 
DE^INEDi 

1, SWAPP4RLE EHT'S 

2, h.HJ'T^ LOADED RESIDENT DURING 
SYSTEM IMTIALIZATION 

FIRST DEFIME THE TOTAL NUMHER OF SWAPPABLE EMT'S 
J (IN OCTAL) IN THe NEXT LINE (UDEMSW = , , , ) , 



UDEMSwsa 



jREPLACE ^ PY NUMBER OF Si^APPABLE 
jEHT'S 



jNEXT DEFINE THE NUMBER OF EMT'S Tn BE LOADED 
jRESIDEMT DiiPING SYSTEM INITIALIZATION, 



UDEMRS=0 :RFPLA 

;USER 
jRESID 
.4FTER THE nLFIMITION OF THE N 
iTHE VALUES OF THE EMT'S MUST 
yTHIS IS DQNiE IN THE MACROS GE 
DO THIS IN Ti^E FOLLO*^ING WAYj 
1 OQ NCrT DEFINE MORE THAN U 
EMT'S TN A SINGLE HACPQ, 
J 2 DO NOT DEFINE BOTH RESIDEN 
I kNO SWAPPABLE EMT'S IN THE 
? 3 START BY DEFINIM6 THE VALU 
: EMT'S l-i MACf^O GEMUfs IF T 
J MORE THAN 13 (OCTAL) VALUE 
J THE DEFINITION IN MACRO GE 
? a THE TITLE OF EMT MODULES M 
J WHERE XXX IS THE OCTAL NUM 
; E.G. EMT 166 HAS A TITLE S 
! .TITLE EM, 166 
! 5 THE LOAr> MODULES SHOULD BE 
1 THE EHT CUDE SHOULD PE POSI 
; LINKED AT A BOTTOM OF 0, 



CE ^ BY NUMBER OF 

EMT'S TO BE LOADED 

E^ir. 

UHBFR OF USER EMT'S, 

BE SPECIFIED, 

MU0-GENU5 

(OCTAL) 

T EMT'S 

SAME MACRO 
ES OF SWAPPABLE 
HERE ARE 
S CONTINUE 
MU 1 

UST BE .TITLE EM, XXX, 
BER OF THE EMT. 
TATEMENT; 

INSERTED IN THE OIL, 
TION INDEPENDENT AND 
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VALUFS OF USER DEFINED EMT'S 
ANGLE BRACKETS. 



JOEFINES FHT'S l«0 AND iHb 



jAFTER THF MATRO DEFiNITIOM, 
yCAN BE I^SE^^TED BETWEEN THE 
jNOTE SEE WuLtSj 
xE,G, ,IRP P,<ia0,ia6> 

.MACRO GEMIJ0 VAL 

,I^P P#<> 

,IIF ECJrPHASE SU8ST<PR0HRT + <P*2>>,VAU 

,I!F NE, PHASE R5?<EWPRIH+<P*2>>.P 

.ENDM 

.E^iDh GEMIJ0 
: AFTER THE MACRO OEFINITinH, VALUES OF USER DEFINED EMT'S 
fCAN BE INSERTED BETWEEN THE ANGLE BRACKETS. 
J NOTE SEE RULES: 
jE.G. ,IRP P,<ia?'fia6> JDEFINES 

.HACf^D GEMUl VAL 

.IMP P,<> 

,IIF EQ, PHASE SUB5T<PR0MRT + <P*2»,VAL 

.IIP ^!E, PHASE R50<EMPRIM + <P*2>>,P 

.EJ^lDf' 

.ENDfi GFMUl 
yAFTEP THE MfiCRO DEFINITIONE 
yCAN RE INSEKTED BtTWEE^' THE 
jNOTE SEE RULES: 
tE.G. .IRP P,<ia0,ia6> 

.MACRO GEMU2 VAL 

,IRP P.O 

.IIF ^G, phase SUB5T<PR0MRT+<P*2>>^VAL 

,IIF ^iE, PHASE R50<EHPRIM+<P*2>>,P 

,ENDM 

.ENQM GEMU2 
?AFTER THE MACRO DEFINITION, VALUES OF USFR DEFINED EHT'S 
fCAN PE INSERTED BETWEEN THE ANGLF BRACKETS. 
;NOTE SEE RULES: 



EMT'S 140 AND \Hb 



VALUES OF USER DEFINED EMT'S 
ANGLE BRACKETS 



JDEFINES EMT'S 143 AND 146 



rc.G, 



JDEFINES EMT'S 14P AND 146 



VALUES OF USER DEFINED EMT'S 
ANGLE BRACKETS. 



JDEFINES EMT'S 140 AND 146 



,IRP p,<ia0,iafe> 

.MACRO GEMIJ3 VAL 

.IRP P,<> 

,TIF Ef5, PHASE SUBST<PR0MRT+<P*2>>,VAL 

.IIF NE, PHASE R5f1<E^PRlM+<P*2>>,P 

,ENDM 

,ENON GEMU3 
jAFTEP THE MACRO DEFINITION, 
jCAN BE INSERTED BETWEEN THE 
jNOTE SEE RULES: 
jE.G. ,IRP P,<14!?!r ia6> 

.^■ACRO GEMU4 VAL 

.IRP P,<> 

.IIP EQ, PHASE SUBST<PR0MRT+<P*2>>,VAL 

,IIF NErPHASE R51?<EMPRIM+<P*2>>»P 

.ENDM 

.ENDM GE^^U4 

PAGE 
jAFTER THE MACRO DEFINITION, VALUES OF USER DEFINED EHT'S 
jCAN BE INSERTED BETWEEN THE ANGLE BRACKETS, 
;NOTE SEE RULES? 
:E,G. .IRP P,<t45i,146> JDEFINES 

.MACRO GEMU5 VAL 

.IRP P,<> 

.IIF EQ, PHASE SUBST<PN0MHT+<p*2>>,VAL 

.IIF ME, PHASE R50 <EMPRIMt<P*2>>,p 

,ENDK 

.ENHM GEMU5 



EMT'S 14? AND 146 
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HAvfc BEEN ADDED AMD THE LINKER SHOULD 

u04D THEM RESIDENT, THE TABLE 

AT LABEL GLOTAB HAS TO BE EXTENDED, 

LE GLOTAB DEFINES THE RADIX50 NAMES OF EMT'S, 

£ REMAIN UNDEFIMED GLOBALS,THE LINKER SEARCHES 

GLOTAB, AND THE TARLE INDEX 
Y TWO OF ANY TABLE ENTRY MATCHING AN UNDEFINED 
LL F-E THE NUMBER OF A EMT TO BE LOADED 

£ GLOBAL NAMES OF USER DEFINED EHT^S 

QLLnwiNiR ??ULES! 

CT 1'30 FROM THE LOWEST DEFINED EMT 

S NUMBER IS X^THEN EXTEND THE TABLE WITH X ZEROES 

XT ,RAD50 /EMX/ 

MX IS THE GLOBAL NAME 

THAN ONE EMT HAS BEEN DEFINED, REPLACE 100 BY THE VALUE 
FMT JUST DEFINED +1, AND TAKE THE NEXT EMT VALUE AS 
EMT VALliE, AND REPEAT STEP 1, 



NOTE! ALL NUMBERS ARE OCTAL 



IF EMT'S 


BE Af^LF T 


STARTING 


THE TA« 


WHEN THER 


THE TABLE 


DIVIDED B 


GLOBAL WI 


RESIDENT. 


TO ADD TH 


USE THE F 


1 SUBTRA 


2 IF THI 


3 ADO NE 


WHERE E 


4 IF MORE 


OF THE 


LOWEST 



GL0TA8J 



,WOPO GLOLST-GLOTAB 

,RAD50 /EMT/ 

.RADSf'' /EMT/ 

,RAD50 /RWN/ 

,RAD50 /RHR/ 

,RAD5P /RWN/ 

,RAD53 /Ri^P/ 

.RADSi? /INR/ 

.RADbv'. /RLS/ 

.RAD^f" /TRA/ 

.RADBE /BLO/ 

,RAD5? /SPC/ 

.RADSf' /STT/ 

,RAn50 /DIR/ 

.RAD5? /ALO/ 

,RAnSi?^ /OPn/ 

.RAD50 /CLS/ 

.RADSP /REN/ 

.RAO^jp /DEL/ 

,RAD5G /APP/ 

.RADSt? /GAR/ 

^RSDSr' /PRO/ 

.RAOSp /RFC/ 

fWORD 

,'^ORD 
PAGE 






jLENGTH 
0,wAITR 
1,WAIT 
WHITE 
NYA 
READ 



OF TABLE HEADER INCLUDED 



6,DATASET INITIALIZATION 
7,DATASET RELEASE 
IfirTRAN PRCFSSOf? 



."^'ORO 

,i*'OPO 

.WORD 

,RADS^.^ 

.RADb? 

,RAD5C^ 

.RADSe 

.RADSC' 

.RAose 

.PADSl? 
.RAl)50 
,RADt30 
,RAD50 
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/SPE/ 

/GUT/ 

/CVT/ 

/FOP/ 

/FCff/ 

/FCL/ 

/LUK/ 

/LBA/ 

/GMA/ 

/CBA/ 



jEMT'S 30-35 



? a'^,MSB OVERLAY PROCESSOR, RESIDENT 
y ai, GENERAL UTILITIES 
t 42, CONVERSION PROCESSOR 
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.^^ADSf' 


/ZY^tf 


.RAD50 


/DLN/ 


,RAn5p 


/DCN/ 


.WAD'S? 


ZAP?/ 


.PADSi? 


/CSX/ 


♦RAD50 


/CSM/ 


,PAn5i,- 


/XIT/ 


,»AOS0 


/LOf?/ 


, f? A n S ? 


/LO?/ 


.PADSP 


/MTO/ 


,53&D5? 


/OMP/ 


, £3 A n S t^ 


/PUN/ 


,f^An',0 


/CDT/ 


.WAnt^i? 


/P3F/ 



? fe5f RUN PROCESSOR 



jADD USFR DtKlNtO GLOBALS IH FRONT OF THE NEXT LINE 

GLOLST; 

;IF NO MO^^ STANDARD DEVICES HAVE TO BE 
fDEFIMFD, THE EDITING OF THIS FILE IS READY, 
.OTHERWISE INSERT THE NUMBER (OCTAL,) 
•OF NONSTANDARn DEVICES m THE NEXT LINE, 



.J0OEV = 3 • 


jFOR EACH ^tn^j STANDARD Dt 


•MNEMONIC AMD If^^fFRRUPT V 


•HAVE TO ^E SPECIFIED. 


jTHE SPECIFICATION OF THE 


•BY MEANS OF THE MACROS G 


•AND GDVU2 USING THE FOLL 


• 1 START DEFINING RY USI 


J GDVUl^ AfiC THERF AFTER 


? a IN EACH MACRO, SPECIF 


; FOR ONLY 3 DEVKfS CA 


; 5 IF THERE ARE 3 OR HOR 


• TO RE DHMF, SPECIFY 3 


•THE MACROS GOVU0, RDVU1 


jPROVIDE THE FACILITY FO^ 


•MORE OFVICrS HAVE TO BE 


yAODITIONAL MACROS ''•'ITH N 


jWITH GDVU3,-,.,, 


jHAVING THE SfiME LAYOUT A 


jGOVU^^, GOVUl AND GDVU?, 


PAG^-" 


J HERE THE MNE^^ONIC AND IN 


! ADDRESS OF UH TO 3 OEVIC 


•IF THE MNEMONICS AND INT 


•ADDRESS ARE RESPECTIVELY 


JX1,X?,X3 AND IVA1,TVA2 A 


jTHEN EDIT THE LINE AFTER 


s ,IRP P,<<X1,IV 


,?'ACRn GDVUe 


.IRo p,<> 


UDEVG P 


.ENOM 


,ENDH GDVU0 


J HERE THE MNEMONIC AND IN 


•ADDRESS OF UP TO 3 DEVIC 


;IF THE MMEMDNICS ANU INT 


?AODRFSS ARE RESPECTIVELY 


?X1,X3,X3 AND IVA1,IVA2 A 



jREPLACE THIS BY OCTAL NUMBER 
;0F NON STANDARD DEVICES, 

VICE, THE 
ECTOR ADDRESS 

SE ITEMS HAS TO BE DONE 
DVUO, GVDUl 
OWING RULES, 
NG GDVU0, NEXT 

GDVU2 
ICATIONS 
N RE GIVEN 
E SPECIFICATIONS 

IN THE CURRENT macRD, 
AND GDVU? 

9 DEVICES, WHEN 
ADDED, ADO 
AMES STARTING 



TERRUPT VECTOR 

ES CAN BE SPECIFIED. 

ERRUPT VECTOR 

• 

ND IVA3 

THE MACRO DEFINITION TO READ: 
A1>,<X?,IVA2>,<X3#IVA3» 



TERRUPT VECTOR 

ES CAN BE SPECIFIED. 

ERRUPT VECTOR 

ND IVA3 
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LINE AFTER THE MACRO DEFINITION TO READ? 
P,<<X1, IVA1>,<X?,TVA2>,<X3# IVA3>> 
GDViJl 

P 



jTHEN EDIT THF 
J .IRP 

.MACfiT! 

UOfcVG 

,FMDt-i 

,FNDM GDVUi 
jHERE THE *^Mt^'QMIC AND INTERRUPT VECTOR 
jADOkESS of 1>P TO 3 DEVICES CANi BE SPECIFIED, 
?IF THE MNE^^ONICS AMD INTERRUPT VECTOR 
•ADDRESS ARE RESPECTIVELV ; 
JX1,X2^X5 fiN[) IVAl,IVA^ AND ivA3 
jTHEN EDIT THF LP^E AFTER THE MACRO DEFlNlTIQKi TO READ? 



.IRP 

.HAC^O 

.IRP 

JDEV3 

,EMD^ 

,ENOH 



3,«)(i,lVAl>,<X2,lVA2>,<X3,IVA3>> 

9 

30VLI? 
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APPENDIX F 



SYSLOD NOTES 



F.l USE OF SWITCHES 



fUi XXU^LI 



TllS oysteiu JbOaClcx ^jTOyxaut jt/j-v^Vl^e* 

may be specified on the output side of the command string. Switches may be 
used only on the output side of the command string, in the general form: 

£output CIL/SWl. . ./SWN< input LICIL 

By including a switch, the user indicates that a particular 
action is to be performed by SYSLOD. Switches are summarized in 
Table F-1. 

TABLE F-1 
SYSLOD SWITCHES 



Switch 


Function 


/ZERO 

/BOOT 
/HOOK 

/BLOCKS : nnn 
/NS : lbs : stb 

/FORMAT 


Zero the disk (initialize the BATCH/ 
DOS- 11 file structure) . 

Boot the output CIL into core. 

Hook the CIL to the bootstrap. 

Allocate nnn blocks for the CIL. 

Non-standard. Load a CIL onto a disk 
that does not have standard DOS file 
structure. 

This switch causes an RKll disk to be 
formatted when DKn; is the output device, 


NOTE: The initial two letters of each switch are all that are 
required; the remainder are ignored. If no switches are 
used, or if the /ZERO switch or /NS switch is not used, 
the output CIL replaces the CIL that is currently hooked 
to the bootstrap. SYSLOD searches the bootstrap for the 
starting block and logical block size of the current CIL, 
and uses these values when creating and loading the new 
CIL. 
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F.2 SWITCH DESCRIPTIONS 
F.2.1 /ZERO Switch 

The /ZERO switch clears every block on the output device, ini- 
tializes the BATCH/DOS-11 file structure, and writes a new bootstrap 
in block 0. The output CIL is installed on the disk as the first 
and only file under the [1,1] User Identification Code (UIC) . 

Example ; 

£DK : MONCIL . CIL/ZE<DT4 : MONCIL . LCL 

F.2. 2 /NS Switch 

The NS (Non-standard) switch is used when the CIL is either 
to be loaded on a disk that does not have a standard DOS- 11 file 
structure, or when the CIL itself does not adhere to the DOS-11 
file structure. All relevant information must be supplied 
by the user, either specifically or by default. The /NS 
switch has the form: 



/NS:lbs:stb 



where : 



lbs = logical block size (a decimal value designat- 
ing words-per-block) . If lbs is not given, 
the standard DOS logical block size is used: 

RCll, RFll = 64 
RKll = 256 
lbs can be used without stb specified. 

stb = starting block number, at which the CIL is to 

begin. Default = 4. Stb cannot be used alone. 
Lbs must also be specified. The value speci- 
fied for stb must be 4 or greater, because 
blocks through 3 are occupied by the Bootstrap. 



The SYSLOD program puts the CIL onto the output disk, with the 
logical block size specified, and at the starting block specified. 
If there is not enough contiguous disk space available, SYSLOD 
prints an error message, and does not attempt to load the CIL. 
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The value of lbs, if specified, must be either 64 or 256, or 
must match the value given in the CIL Line. This ensures that 
SYSLOD will allocate enough blocks for the CIL Index. 



If the CIL is to be hooked, the bootstrap requires 
that the value of lbs be a multiple of 64. 



The /NS switch and /ZERO switch are miutually exclusive. An 
error message is produced if they appear in the same command string. 
All other SYSLOD switches can be specified, however. See Table F-2. 

Example : 

#DF : JHR. CIL/NS : 256 : 40<DTj2f : JHR. LCL 

The input dataset is a Linked CIL named JHR. LCL, resident on 
DECtape unit 0, SYSLOD puts the output CIL (JHR. CIL) on the RFll 
disk, starting at logical block 40, with a logical block size 
of 256 words per block. 

F.2.3 /BOOT Switch 

The /BOOT switch causes the output CIL to be booted into core 
and executed, after it has been loaded onto the disk by SYSLOD. It 
is only necessary to specifically request that this be done when the 
/NS switch is used (refer to Section 2.1.4.2). If the /NS switch 
is not used, /BOOT is assumed by default. 

Example : 

#DK1:M0NCIL. CIL/NS: 256 :4jZf/BO<DTj2f:MONCIL. LCL 

The Monitor CIL is specified to be loaded onto RKll unit 1. 
The file structure is assumed to be unknown. Thus, it is necessary 
to specify /BO to boot in the CIL, and begin its execution. 

F. 2 . 4 /HOOK Switch 

The /HOOK switch causes the bootstrap on the output disk to be 
updated with information pertaining to the output CIL, so the boot- 



F-3 



strap will boot that CIL into core when it is executed. If the /NS 
switch is not used, the /HOOK switch is assumed by default. 

Example ; 

£DC:MONCIL.CIL/NS:256 : 3j2f/HO<DT :MONCIL 

The CIL (MONCIL.CIL) is loaded onto the RCll disk, with a 
logical block size of 256 words, starting at logical block 30. 
The bootstrap on the disk is updated to reflect the following 
information about MONCIL.CIL. 

a. Start block of first core image in the CIL. 

b. Size (number of bytes) of first core image in the CIL. 

c. Load address in core of first core image in the CIL. 

d. Start address of first core image in the CIL. 

e. Pointer to first block of the CIL (block 3j3) . 

F.2.5 /BLOCKS Switch 

The /BLOCKS switch is used to allocate a specified number of 
logical blocks for the output CIL. In this way, extra disk space 
can be reserved for later extension to the CIL. The switch is 
specified as 

/BL[OCKS] :NNNNN 

where NNNNN is a decimal number, up to five digits long, specifying 
the number of logical blocks to be allocated. 

The /BLOCKS switch cannot be used alone. It must be used in 
conjunction with either the /ZERO or the /NS switch. When used 
with the /ZERO switch, /BLOCKS allocates more than the minimum number 
of blocks required for the CIL. When used with the /NS switch, 
/BLOCKS ensures that only the number of blocks specified 
are written into by the CIL. For example, assume that the user 
knows that there are 100 blocks of contiguous space available, 
starting at block 500 on the disk. He wishes to load the CIL into 
this space, but is not sure how many blocks are needed. To make 
sure that block 600 will not be destroyed by the CIL, he would 
specify the following command string: 
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#DK1 : SYS . CIL/NS : 256 : 5j2fj2f/BL: lj2f0<PR: 

SYSLOD computes the nuirJDer of blocks needed before it attempts 
to load the CIL. If more than 100 are needed, it prints the message 

LICIL TOO BIG, NOT ENOUGH RESERVED BLOCKS I 

on the teleprinter, and restarts, typing # at the beginning of the 
next line. 

If the user has specified enough blocks, the CIL is loaded as 
specified. If the /BLOCKS switch was not used, the CIL would be 
loaded, starting at block 500, up to the number of blocks required, 
heedless of the contents of the blocks into which it was being 
loaded. The minimum-number-of-blocks value is determined by 
examining the CIL Line, which was produced by CILUS at the time 
the LICIL was generated. 



F.2.6 /FORMAT Switch 

This switch may be included only when the output disk is an 
RKll unit. Its function is to put maintenance format information 
on the disk, such as the start of physical blocks, sectors, etc. 
If the /FO switch is specified for an RCll or RFll disk, it has 
no effect. 

Example : 

#DKj2f : MONLIB . CIL/FO<MT0 : MONLIB . LCL 
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F. 2 , 7 Switch Combinations 

Table F-2 illustrates the legal combination of SYSLOD 
switches. 

TABLE F-2 
LEGAL SYSLOD SWITCH COMBINATIONS 





ZERO 


NS 


BLOCKS 


HOOK 


BOOT 


FORMAT 




ZERO 




I 


L 


L,D 


L,D 


L 




NS 


I 




L 


L 


L 


L 




BLOCKS 


L 


L 




L 


L 


L 




HOOK 


L,D 


L 


L 




L 


L 




BOOT 


L,D 


L 


L 


L 




L 




FORMAT 


L 


L 


L 


L 


L 







LEGEND 



NOTES: 



L - Legal 
I - Illegal 
D - Default 



1. /ZERO and /NS are mutually exclusive. 

2. /HOOK and /BOOT are set by default unless /NS is used. 

3. /HOOK and /BOOT can be used with any switches. 

4. /BLOCKS requires that either /ZERO or /NS be used. 

5. /FORMAT is usable only with RKll disks. 
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F.3 SYSLOD ERROR MESSAGES 

F.3.1 Recoverable Errors 

The following errors are diagnosed and reported by SYSLOD. Once 
the error message is printed, SYSLOD will restart by identifying it- 
self acfainj and orintina the # (inout rsciuest^ character on thp 
teleprinter. The user should retry the coinmand, making the indicated 
corrections . 

1. SYNTAX ERROR 

This message is printed if the command input line has a 
syntax error. The offending line is printed up to the 
first error character, with a question mark following 
the error chara*^'*"©'*^ 

EXAMPLE : 

DKl :FILE$LDA<DT1 :FILE .LCL 
This line would be echoed as follows: 

DK1:FILE$? ) 

2. TOO MANY DATASETS 

SYSLOD accepts one input dataset and one output dataset. 
This message occurs when more than one input or output 
dataset is specified in the command line. 

3. TOO MANY SWITCHES 

SYSLOD does not accept any switches from the input dataset. 
If more output switches are used than can be accom- 
modated, SYSLOD issues this error message. 

4. UNKNOWN SWITCH 

If a switch is typed that is not one of those recognized 
by SYSLOD, this message is issued. 

5. SWITCH ERROR 

This error message is reported if a switch is used in- 
correctly. E.g. , 

/ZE:1 ZE[RO] does not take arguments 

/BL/HO BL[OCK] requires a decimal argument 

6. SWITCH CONTEXT ERROR 

This error is reported when switches are specified in- 
correctly for their definitions, e.g., 

a. If BL[OCKS] or FO[RMAT] is specified /ZE or 
/NS must be specified also. 
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b. /NS and /ZE cannot both be specified, 

7. ERROR IN SWITCH ARGUMENT 

Decimal arguments given with /NS or /BL are too large 
for 16 bits. 

8. NON-EXISTENT DISK OR DISK NOT READY 

A legal disk name was given for the output dataset, but 
the device either is not part of the system configuration 
or is not ready. 

9. UNKNOWN DISK NAME SPECIFIED 

SYSLOD accepts the following disk names as part of the 
output dataset: 

DC 1 to 4 disks 

DF 1 to 8 disks 

DK HIGH or LOW density 

10. ERROR WHILE FORMATTING RK DISK 

Any disk error while formatting the RK disk will cause 
this message. 

F.3.2 Non-recoverable Errors 

There are two types of non-recoverable errors. First, the 'F' 
errors, which are the same as those in DOS-11. Refer to the DOS 
Monitor Programmer's Manual. 

The second type of non-recoverable errors are described below. 

1. INPUT IS NOT A LICIL 

The first line of the input file was not COMD section 
#4 (see F.4, Note c) . This will usually occur when the 
user tries to SYSLOD a load (.LDA) module instead of a 
LICIL. 

2. END OF FILE BEFORE CIL LINE READ 

This occurs when SYSLOD is looking for the CIL line but 
can't find it. Typically this occurs because the user 
put the wrong paper tape in the tape reader, when he has 
many tapes comprising the whole LICIL. When the input 
is from DECtape or magnetic tape, this message usually 
indicates that the file has been destroyed, and must 
be rebuilt. 
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3. BOOTSTRAP NOT IN BLOCK 

This can only occur in 'replace' mode (/NS and /ZE[RO] not 
specified) . In this mode, SYSLOD finds the GIL to be re- 
replaced on the disk by looking at the bootstrap parameters. 
If the first block number of the CIL hooked to the boot- 
strap (i.e. LOCATION 176 OF BOOT) is then block is 
certainly not a hooked bootstrap, 

4. BOOTSTRAP NOT HOOKED TO CIL; CANNOT REPLACE 

This can only occur in 'replace' mode. If the first block 
indicator of the bootstrap (LOCATION 176) is non-j?, it 
must be pointing to a CIL, If the first formatted binary 
line of the 'hooked' file is not COMD section #3 it is 
not a CIL. 

5. BLOCK SIZE DISCREPANCY BETWEEN CILUS AND SYSLOD 

This occurs when the /NS switch is used with CILUS or SYSLOD 
but not both, (i.e., exactly the same parameters must be 
specified with SYSLOD that were specified with CILUS) . 

6. LICIL TOO BIG, NOT ENOUGH RESERVED BLOCKS 

a. In replace mode this occurs when the new LICIL is 
larger than the old, 

b. If not replace mode, the number of reserved blocks 
(/BL:Nnnnnn) is not large enough to hold the CIL. 

7. 1^^ LINE NOT COMD SECTION #4 or 1 

After the CIL line is read, SYSLOD starts loading the 
LICIL. The first formatted binary line after the CIL 
line must be COMD section #4 or COMD section #1. After 
each core image is loaded, SYSLOD sets itself for loading 
a new core image. If the beginning of the new core image 
is not COMD section #4 or #1, this error message will 
result. 

8. COMD SECTION #4 SEQUENCE ERROR 

This will occur when the user has a LICIL made up of 
many paper tapes . If the tapes are not read in the 
correct sequence, this error will result. 

9 . INPUT ERROR 

After a READ, the status in the buffer header indicated 
that one of the following errors occurred: 

a. invalid line error 

b. checksum error 

c. character parity error or illegal binary format 

d. device parity error 



10. LOGICAL BLOCK SIZE ERROR 

This occurs when the logical block size given with the 
/NS switch is not an even multiple of the default logical 
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block size. E.g., a block size of 10^ for RFll is not 
an even multiple of the default size of 64 . 

11. END OF DISK BEFORE CIL COMPLETE 

The last block number of the output disk has been written, 
but the CIL is not complete. 

F.3.3 Non-fatal Error 

The following error is reported by SYSLOD but does not stop 
the loading process. 

1. DISK ERROR AT DECIMAL BLOCK #NNNN, SYSLOD WILL CONTINUE 

After a TRAN out, the status word of the TRAN BLOCK is 
examined. If it shows an error, the TRAN is retried 10 
times. If the error persists, the offending block number 
is printed, after which SYSLOD proceeds. 

F . 4 NOTES 



A. If the default block size is not used the following restric- 
tions apply: 

1. The argument block size must not exceed 256 words. 

2. The block size must be an even multiple of the default 
size for the disk. 

B. If magnetic tape is the input medium, and the wrong filename 
or UIC is given, SYSLOD will halt at 24432o instead of 
printing F012. 

C. The COMD ( COMm unication Directory) contains a code number 
that identifies the kind of information that follows. 
SYSLOD expects the first formatted binary line it receives 
on input to be identified as code #4 (indicating that it is 
a LICIL) . 



F-10 



APPENDIX G 



CILUS NOTES 



G.l CILUS SWITCHES 

Switches may appear in a CILUS command on either the output 
side or the input side. 

G.1.1 Output Switches 

Output switches are: 

/HOOK - Hook the output CIL to the bootstrap. 
/BOOT - Boot the output CIL. 

G.l. 2 Input Switches 

Input switches include: 

/LOAD - Loads a CIL or LICIL onto disk or DECtape. 

/LIST - Produces a directory listing of a CIL or 
LICIL. 

/BUILD - Creates a CIL or LICIL. 

/E - Indicates the end of input datasets. 

G.2 CILUS COMMAND STRINGS 

The general form of a CILUS command string is: 

#CIL , LISTING , LICIL<PRIMARY , SECONDARY/E 

All output datasets are optional, but at least one output data- 
set must appear in the command string. No default is assumed. The 
order of appearance determines the function of the datasets. I.e., 
if all three are specified, then (from left to right) they are de- 
fined to be the CIL dataset, the listing dataset, and the LICIL 
dataset. If a leading dataset is omitted, it must be indicated by 
a comma in its place, e.g.: 

#CIL, ,LICIL<PRIMARY, SECONDARY/E 
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indicates that the listing dataset is omitted, 
devices are shown in Table G-1.. 



Legal output dataset 



Table G-1 



CILUS OUTPUT DEVICES 



Dataset 
Type 


Disk 


DECtape 


Magtape 


Paper tape 


Printer/ 
Keyboard 


CIL 


X 


X 








LICIL 


X 


X 


X 


X 




Listing 


X 


X 


X 


X 


X 



NOTES 

A CIL cannot be stored on paper tape or 
magnetic tape because DOS-11 does not 
support contiguous files on these devices 

The LICIL format provides the means for 
distribution of CIL's on papertape and 
magnetic tape, as well as on disk and 
DECtape. 



Output switches can be specified for either the CIL or the 
LICIL, but not for both in the same command string. 

Input datasets consist of at least a primary dataset (required) , 
and one or more secondary datasets (optional) . Secondary input data- 
sets can be continued on as many lines as necessary, terminated by 
the /E switch. 

When LOADing or LISTing, only a primary input dataset is allowed 
(which must be a CIL or LICIL). For example: 

#OUTCIL , LP : < INCIL/LOAD 

This loads INCIL under the name OUTCIL, on the system disk (by 
default) and produces a listing of OUTCIL' s directory on the line 
printer. 

#LP:<INCIL/LIST 
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This produces a directory of INCIL's contents on the line 
printer. 

The /E switch is not needed for either /LOAD or /LIST. 

The /BUILD switch requires a primary input dataset, and ac- 
cepts optional secondary inputs. The input datasets can be CIL's, 
LICIL's, or load modules. 'They are built in the order specified, 
to produce the specified output. The /BUILD switch must appear 
immediately after the primary dataset; e.g., 

#LIB , LP : , SY : LIBLCL< INLIB/BU , MODI ,M0D2/E 

The contents of INLIB, MODI, and M0D2 (in that order) are 
built into the CIL named LIB. A line printer listing, and a 
LICIL (LIBLCL) are also output (to the system device, as indicated 
by SY:). The /E switch is required. 

G. 3 EDIT COMMANDS 

A CIL can be edited by means of the following commands: 



INSERT 

REPLACE 

DELETE 

PURGE 

EXECUTE 



To edit a CIL, specify a command string with no action switch 
on the input side (i.e., no /LOAD, /LIST, or /BUILD). CILUS 

responds by printing * on the next line. Edit commands can be 
used, as follows (NOTE: only the first letter of each command is 
required) : 

INSERT 

*I P1:S1 

where PI - the name of a module in the primary 
input dataset; 

SI - the name of a module in the second- 
ary input dataset. 

Result: SI is inserted into the primary input 
dataset ahead of PI. 
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*I P1:S1,S1A,S1B 

where PI - Primary dataset module 

Sl-SlB - Secondary dataset modules. 



Result; 



SI, SIA, SIB are put into primary data- 
set (in that order) ahead of PI. 
NOTE: SI, SIA, SIB must also appear 
in this order in the secondary data- 
set. 



*I S1,S1A,S1B 



where SI, SIA, SIB - Secondary dataset modules. 



Result: 



Because no primary input dataset 
module is specified, SI, SIA, and 
SIB are appended to the primary 
input dataset, in the order in 
which they appear in the secondary 
input dataset (their order in the 
command is ignored) . 



REPLACE 



*R P1:S1 



where PI - Primary input dataset module to be 
replaced. 

SI - Secondary input dataset module that 
replaces PI. 



DELETE 



*D P1,P2, 
where 



*PURGE 



,Pn 



♦EXECUTE 



Delete can be used to eliminate 
modules from the primary input 
dataset only (pi,p2 , . . .Pn) . 



This command is used to correct 
errors made while specifying edit 
commands. If a wrong module was 
specified to be deleted, replaced, 
etc. , specifying *P clears all pre- 
vious edit command input. The edit 
commands can now be entered correctly, 



When all edit commands have been 
properly entered, use this command 
to cause the editing to be performed. 
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TMP 
UFD 



APPENDIX H 



RESERVED FILENAME EXTENSIONS 



Extension Attribute 



ALG ALGOL source file 

BAS BASIC source file 

BAK Backup file 

BLI BLISS source file 

CBL COBOL source file 

CIF Core Image File 

CIL Core Image Library 

CMD Command file 

CRF Input to cross-referencing program 

DAT DATA file for FORTRAN job 

DDT Reserved for DDT 

DGN Diagnostic message file 

FTN FORTRAN source file 

FCL FOCAL source list 

LBO Library of object modules (other types of 

libraries may also be implemented) 

LCL Linked core image library 

LDA Load module. Absolute 

LDR Load module, Relocatable 

LOG Logging file 

LSP LISP source file 

LST Listing file 

MAC MACRO assembler source file 

MAP MAP file 

MFD Master file directory 

OBJ Object module 

OP^ Program generation information 

OVR Overlay 

^^ PAL assembler source file 

PLl PL/1 source file 

RNO Reserved for RUNOFF program 

^OL Reserved for ROLLIN program 

RPG RPG source file 

SNO SNOBOL source file 

SPC SPEC format text 

STB Symbol Table (Link-11 output) 

SYM File of symbols 

SYS System management 

Temporary scratch file 

User file directory 



H-1 



INDEX 



Addition/ 

of Device Drivers, 4-4 

of EMT- Module, 4-6 
Algorithm, B-1 

Allocate Blocks (/BL) switch, F-4 
Angle brackets, 3-5 
Asseiiibler, MACRO-11- 1-3 
Assembly, 

of Device Driver, 4-2 

optional parameters for, 4-1 

of System Program, A-1 
Asterisk (*) symbol, 6-4 
Auxiliary buffer, B-1 



Backup procedures, 2-18 

Batch Stream, 2-9, A-1 
DECtape, A-11 
DECtape Build, A- 6 
Getting on the Air, A- 8 
Magnetic Tape, A-1 3 
Magnetic Tape Build, A- 7 
Paper Tape Build, A- 4 
System Generation, A-1 

BATMAN input file, 5-3 

Binary data, 4-3 

Bit map, B-1 

Blank suppress option, 4-3 

Block 

Dataset Data (DDB) , B-1 
File Information (FIB) , B-1 
logical, 1-5, F-4 

allocation of, F-4 
physical, 1-5 
size, F-10 

default, F-10 

/BLOCKS switch, F-4 

Boot, 1-5 

/BOOT (/BO) switch, 2-7, F-3 

Bootstrap, 1-6 

Buffer, B-1 

auxiliary, B-1 

Build switch, G-3 

Building Configuration Module, 
3-1 



CILUS (cont'd) 

command strings, G-1 

output device, G-2 

switches, G-1 
input, G-1 
output, G-1 
CLGf.SYS (default file), 5-6 
CL1-CL5.SYS, 5-5, 5-7 
CL6-CL7.SYS, 5-6 
"Clean-up" tasks, 5-4 
Clock, 

line frequency (KWll-L) , 3-3 

programmable (KWll-P) , 3-3 

routine 

definition of, 3-3 
CMDS input file, 5-3 
Code, 

card, 4-3 

User Identification (UIC) , 6-1 
COMD (COMmuni cat ions Directory) , 1-6 

error code, F-10 
Command, 

$CH, A-1 

concise, 5-1 

edit, G-3, G-4 
Comment lines, 5-6 
Compiler, FORTRAN, 1-1 
Components, FORTRAN, 1-4 

Monitor, 1-2 
Configuration, of hardware, 3-8 
Configuration Module, 1-2, 1-3, 3-1 

building, 3-1 

modifying, 3-6 

source file (SYSTEM. MAC) , E-1 

standard, E-1 
Conventions 

for Device Driver naming, 4-1 
Core Image, 1-6 

Core requirements, system, B-1 
Core Size, 2-11 

Linker relationship to, 2-11 

Macro relationship to, 2-12 
Correcting errors, G-4 
CRll/CMll, 4-1 



Card codes, 4-3 

Cautions, 3-9 

CCL input file, 5-3 

$CH command, A-1 

$ CHANGE command, 5-4 

Changing default dataset, 5-2 

CIL (Core Image Library) , 1-6 

dataset, G-1 

Line, 1-6 
CILUS (Core Image Library Update 
and Save) program, 1-7 



Dataset, 5-1, G-1, G-2 
CIL, G-1 
default, 5-2 

changing the, 5-2 
LICIL, G-1 
primary, G-2 
secondary, G-2 
listing, G-1 
Dataset Data Block (DDB) , B-1 
DC:, 2-6 
DECtape, 4-1 
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Default, 

block size, F-10 

file (CL0.SYS) , 5-6 

log, 5-4 

SYSLOD, 2-7 

UIC, 6-2 

modifying, 5-7 
value , 3-2 
as 0,0, 3-3 
changing, 3-2 
Deletion, 

of drivers, 4-5 

of EMT Module, 4-6 

of files (/DE) switch, 6-5 
Density, 

low, 4-3 

mixed, 4-3 
Descriptions of switches, F-2 
Device , 

CILUS output, G-2 

initialization of, 6-6 

non-standard, 3-5 

standard, 3-3 

system (SY) , 2-12 
Device drivers, 4-1, B-4 

parameters of, 4-3 

sources for, 1-5 
DF:, 2-6 
Directory, Communications (COMD) , 

1-6 
disdev, 2-6 
Disk, 

RCll, 4-1 

RFll, 4-1 

RKll, 4-1 
Distribution kit, 1-1, 1-2 

building of, A-1 
Distribution media, putting 

system programs on, A-1 
DK0:, 2-6 
Drivers, 1-5 

adding, 4-4 

deleting, 4-5 

device, 4-1, B-4 
assembling, 4-2 
naming conventions, 4-1 

name of, 

QT version, 4-3 
DT0:, 2-6 



/E switch, G-3 
Edit, 

commands , G- 3 

of procedure files, 5-3 

assembling and linking, 5-3 

of job termination files, 5-7 
Editor program, 1-4 
EDP (Error Diagnostic Print) 

routine, 3-11 
EMT Modules, 

Monitor, C-11 



EMT Modules (cont'd) 

user-written, 3-4 
swappable, 3-4 

values of, 3-4 
Entering UIC (/EN) switch, 2-20, 

6-3 
Entry point, 3-6 
Error, 

COMD (COMmuni cat ions Directory) , 
code, F-10 

correction of, G-4 

dumping of, 5-4 

initial system load, 3-10 

message, SYSLOD, F-7 

parity, 2-5 

SYSLOD, 2-5, F-7 
Error Diagnostic Print Routine, 

3-11 
Explicit UIC, 6-3 



'F' error, F-8 
Facilities, of system, 4-1 
File, 

superseding a, 6-6 

transfer, 2-13, 6-5 

to System Manager area, 6-6 
File Deleting (/DE) switch, 6-5 
File Directory Listing (/DI) 

switch, 6-4 
File Dump program, 1-4 
File Information Block (FIB) , B-1 
Filename extensions, reserved, H-1 
$FINISH, 

card, 5-4 

statement, 5-6 
/FORMAT (/FO) switch, 2-6, F-5 

maintenance format information 

on disk, F-5 
FORTRAN , 

compiler, 1-1 

components, 1-4 



Getting on the Air (GOA) , 1-1, 2-1 

Batch Streams for. A- 8 
Getting Systems Programs on the 

Air, 2-9 
Global, 

name, C-1 

symbol, 5-2 



Hardware configuration, 3-8 
/HOOK (/HO) switch, 1-6, 2-7, F-3 



IDENT, 3-5 

Initial system load errors, 3-10 

Initialization, 

device (/ZE) switch, 6-6 
error, 3-11 
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Initialization (cont'd). 
Monitor, 

command strings for, 3-8 

overview of, 3-7 
Input files, 5-3 
Installation procedures, 2-1 
Invoke BATCH, 2-10 



$JOB statement, 5-7 
Job termination, 

editing files for, 3-7 

processing, 5-4 

system files for, 5-4 



Kit, 1-1, 1-2 
DECtape, D-3 
magnetic tape, D-3 
paper tape, D-1 
system distribution, D-1 



Legal SYSLOD switch combinations, 

F-6 
Librarian, 1-4 
Library, 

linked core image, 1-6 

won 1 to r , J.— £. 

system macro, 1-3 
LICIL (Linked Core Image Library) , 
1-6, 1-7 

dataset for, G-1 
Line frequency clock (KWll-L) , 3-3 
Link system programs, 2-14 
Linker, 

program, 1-4 

relationship to core size, 2-11 
Listing, 

of dataset, G-1 

of UIC (/UIC) , 6-2 
Listing File Directory Switch, 

(/DI) , 6-4 
LKP input file, 5-3 
Loader, System (SYSLOD), 1-7, 2-1 
Loading Monitor, 2-5 

dLJ>-''S5 -l-ii, j-rf- ^ O ^-» C V-A !-A J- ^ii / £* -/ 

Logical blocks, 1-5, F-4 
LPll, 4-1 



Modifications , 

Configuration Module, 3-6 
default UIC, 5-7 
Monitor, 3-1 
Module, 3-6 

Configuration, 1-2, 1-3, 3-1 
dataset, G-4 

primary, G-4 

secondary, G-4 
DEC-supplied, 3-6 
EMT, 4-6 

adding, 4-6 

deleting, 4-6 

Monitor, C-1 

replacing, 4-6 
non-reentrant, 3-12 
order of, 4-5 
reentrant, 3-12 
size of, B-2 

standard configuration, E-1 
transient, 3-11, B-3 

uocjl ouppxxea wi iiujiaxo-xcQ , j — u 

Modules calling S.GTB, S.RLB, 3-12 
Monitor 

BATCH-11, 1-3, 5-1 
components, 1-2 
initialization of, 
command strings, 3-8 
overview, 3-7 
loadxng , ^—j 
modification, 3-1 
procedures , 

BATCH-11, 2-9 
DOS-11, 2-11, 2-17 
rebooting, 2-8 
size of Resident, B-1 
temporary , B- 3 
Monitor EMT Modules, C-1 
Monitor Library, 1-2 
MTJZf:, 2-6 



Name, global, C-1 

Naming conventions for Device 

Drivers, 4-1 
Non-reentrant module, 3-12 
Non-standard devices (VAR) , 3-5, 

/NS (Non-standard) switch, F-2 



MACRO- 11 

Assembler, 1-3 

Symbol Table, 1-3 
Macro relationship to core size, 

2-12 
Magtape procedures, 2-4 
Magnetic tape, 4-3 

error, F-10 

format information to disk 
(/FORMAT) switch, F-5 
Media, 1-2 
Mode, restricted, 6-1 



On-Line Debugging program, 1-4 

Order, of modules, 4-5 

Object Time System (OTS) , 1-1, 1-4 



P command (PURGE) , G-4 

PALllR subset, 1-3 

Paper tape procedures, 2-1 
DECtape, 2-3 

Parameters , 

Device Driver, 4-3 
optional assembly, 4-1 
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Parameters (cont'd), 

SYSDEV, 4-3 
Parity error, 2-5 
Physical block, 1-5 
PIP, 1-4 

system management facilities of, 
1-4 
PR: , 2-6 
Primary dataset, G-2 

module of, G-4 
Print columns, 4-3 
Procedures, BATCH-11, 2-9 

backup, 2-18 

DECtape, 2-3 

DOS-11 Monitor, 2-11, 2-17 

installation, 2-1 

log-in, 2-9 

magtape, 2-4 

paper tape, 2-1 

RCll, 2-16 
Procedure files, assembling and 

linking edited, 5-3 
Program, 

Core Image Library Update and 
Save (CILUS) , 1-4 
stand-alone, 1-7 

Editor, 1-4 

file dump, 1-4 

On-line Debugging, 1-4 

ROLLIN Utility, 2-18, 2-19 

stand-alone, 1-7 

system, 1-1, 1-3, 3-6 
Programmable clock (KWll-P) , 3-3 
Protection, 6-1 
Punched cards, 4-3 
Putting system programs on dis- 
tribution media, A-1 



QT version of driver name, 4-3 



RCll, 

disk, 4-1 

procedures, 2-16 
Rebooting Monitor, 2-8 
Reentrant module, 3-12 
Reloading system disk, 2-20 
Replacing 

drivers, 4-5 

EMT Module, 4-6 
Residency, 3-11 
Resident Monitor size, B-1 
Restricted mode, 6-1 
Rewind function, 4-3 
RFll disk, 4-1 
RKll disk, 4-1 

drive for 4-3 
ROLLIN Utility Program, 2-18, 2-19 
Run PIP, 2-9 



Secondary dataset, G-2 

module of, G-4 
Size, stack, B-4 
Sources, device driver, 1-5 
Stand-alone program (CILUS) , 1-7 
Standard devices, 3-3 
Statement, 

$FINISH, 5-6 

$JOB, 5-7 
Subset, PAL-llR, 1-3 
Superseding files, 6-6 
Swappable user-written EMT's, 3-4 
Switch, 

/BL[OCK] , F-4 

descriptions of, F-2 

/BOOT (/BO) , F-3 

/BUILD, G-3 

CILUS, G-1 

combinations, F-6 
legal SYSLOD, F-6 

/E, G-3 

/FORMAT (/FO) , F-5 

/HOOK (/HO) , F-3 

/NS (Non-standard) , F-2 

SYSLOD, F-1 

uses of, F-1 

/ZERO (/ZE) , F-2 
SY: (system device) , 2-12 
Symbol, global, 5-2 
Symbol Table, MACRO- 11, 1-3 
SYSDV parameter, 4-3 
sysdev, 2-6 
System 

core requirements of, B-1 

disk reloading of, 2-20 

distribution kit of, D-1 

facilities, 4-1 

files for job termination by, 5-4 

load errors of, 
initial, 3-10 
System Generation Batch Streams, A-1 
System Loader program (SYSLOD), 1-1, 
1-2, 1-7, 2-1 

defaults of, 2-7 

error messages, F-7 
non-recoverable, F-8 
recoverable, F-7 

notes, F-1 

switches, F-1 

using with existing system disk, 
2-20 
SYSTEM. MAC (Configuration Module 

Standard Source File) , E-1 
System Macro Library, 1-3 
System management, PIP, 6-1 
System, Object Time (OTS) , 1-3, 1-4 
System programs, 1-1, 1-3, 3-6 

assembly of, A-1 

building, A-15 

linking of, 2-14 

on distribution media, A-4 



S.GTB calling module, 3-12 
S.RLB calling module, 3-12 



Tape, magnetic, 4-3 
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Temporary Monitor, B-3 
Termination of job processing, 5-4 
Terminology, 1-5 

Title, Configuration Module, 3-5 
.TMON input file, 5-3 
Transferring files, 2-13, 6-5 

to System Manager's area, 6-6 
Transient modules, 3-11, B-3 
TUlO, 4-1 



User Identification Code (UIC) , 

2-20, 6-1 
default, 6-2 
default value, 3-2 

change of, 3-2 

specifying 0,0 as, 3-3 
entering, (/EN), 2-20, 6-3 
explicit, 6-3 
listing, 6-2 

modifying default UIC, 5-7 
withdrawal (/WD) switch, 6-3 
User written EMT's, 3-4 

Value, 3-4 

VAR (Non-Standard devices) , B-2 

XjJA 4-'U^-^-^,.-,A -^^ TTX(-1 I -, / /T.7rN\ /- -I 
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HOW TO OBTAIN SOFTWARE INFORMATION 

Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-11 

Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S. A, customers may order 
directly from the Program Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 

DECUS 

Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 



READER'S COMMENTS 
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Manager's Guide 
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Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 

of its publications. To do this effectively we need user feedback — your critical evaluation of 
4.ut. _._„.._! 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 



Did you find errors in this manual? If so, specify by page. 



How can this manual be improved? 



Other comments? 



Please state your position. Date: 



Name: Organization: 

Street: ^ Department: 



City: State: Zip or Country 
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